MRISA

Meta Reverse Image Search API

© 2017. Reza Snowdon

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!