MRISA
MRISA (Meta Reverse Image Search API) is a RESTful API which takes an image URL, does a reverse Google image search, and returns a JSON array with the search results.
Usage
Install the necessary dependencies:
pip install certifi flask pycurl beautifulsoup4
Start the server with:
python mrisa/server.py
API
Perform a Reverse Image Search
Performs a reverse image search using the supplied image URL as input.
URL
Arguments
- image_url - A URL to an image to use for the search input.
Request Example
curl -X POST http://localhost:5000/search
-H "Content-Type: application/json"
-d '{
"image_url":
"http://placehold.it/350x150.png"
}'
Response Example
{
"descriptions": ["test description", "..."],
"links": ["http://test_link.com", "..."],
"similar_images": ["http://test_image.jpg", "..."],
"titles": ["test title", "..."]
}
Using cURL to make a call to the API
curl -X POST -H "Content-Type: application/json" -d '{"image_url":"http://upload.wikimedia.org/wikipedia/commons/2/29/Voyager_spacecraft.jpg"}' http://localhost:5000/search
There is a client implentation in python in the repository but it should be nice and easy to create one in most languages.
Download
Find out more and download a copy from GitHub. Better yet, check out the repo and play about with the code ;).
Acknowledgments
Many thanks to everyone who has contributed, used and starred the project on github.
Special thanks to:
- Doggan for his extensive improvements in all areas
- Quantomicus for making the project v3 compatable.
- daniel1111 for adding 'best guess' and fixing parsing of links in the search results
Contributions are always welcome, so please don't hesitate to get in touch!