Meta Reverse Image Search API

© 2017. Reza Snowdon


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.


Install the necessary dependencies:

pip install certifi flask pycurl beautifulsoup4

Start the server with:

python mrisa/


Perform a Reverse Image Search

Performs a reverse image search using the supplied image URL as input.



  • 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 '{

Response Example

    "descriptions": ["test description", "..."],
    "links": ["", "..."],
    "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://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.


Find out more and download a copy from GitHub. Better yet, check out the repo and play about with the code ;).


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!