Reverse Image Search API

Programmatically access 'Search By Image' data

Our reverse image search API gives you easy, programmatic access to search the internet using an image file or URL. Submit your image, and our API will respond with every webpage which hosts that image, along with a host of information about the page and image.

As we use engines which search based on an image's features, our API finds websites using an image, even if the image has been renamed, resized, or edited.

With pricing from $3.60 per 1,000 searches, we beat our competitors on both cost and search quality. Partners optionally get a completely whitelabelled interface, SLA-backed dedicated search infrastructure, and custom analysis on search result or infringing pages.

This API is primarily built for copyright enforcement firms, and has a number of features to support this activity.

How it works

1. Send search request

Method: POST Endpoint: https://api.infringement.report/2.0/search Parameters
  • images: A JSON object containing each of the images that you wish to search
  • list_label: An optional label so that you can identify this list later
For example:

2. Get the webpages using those images

{
    "status": true,
    "code": 100,
    "list_id": 608,
    "result": [
        {
            "title": "animal | no ordinary world",
            "url": "https://thisisnoordinaryworld.wordpress.com/tag/animal/",
            "host": "thisisnoordinaryworld.wordpress.com",
            "protocol": "https:",
            "image_url": "https://thisisnoordinaryworld.files.wordpress.com/2013/03/lion_waiting_in_namibia.jpg",
            "image_width": "1280",
            "image_height": "960",
            "image_width_on_page": "259",
            "image_height_on_page": "194",
            "date": "Mar 6, 2013",
            "description": "Posts about animal written by elenasuglia and No Ordinary World.",
            "user_id": 1,
            "list_id": 608,
            "image_id": 4973,
            "search_id": "ZTAzuWH3FUPS6NYQpsPVG6dgha1fui6h",
            "search_image_url": "https://upload.wikimedia.org/wikipedia/commons/7/73/Lion_waiting_in_Namibia.jpg",
            "found_timestamp": "2017-11-27T09:20:24-0500",
            "seen_timestamp": "2017-11-27T09:20:24-0500",
            "debug": {
                "foundOn": 20
            },
            "result_hash": "75d2ebe3f9e5143249576c0015b7291c"
        },
        {
            "title": "List of carnivorans by population - Wikipedia",
            "url": "https://en.wikipedia.org/wiki/List_of_carnivorans_by_population",
            "host": "en.wikipedia.org",
            "protocol": "https:",
            "image_url": "https://upload.wikimedia.org/wikipedia/commons/7/73/Lion_waiting_in_Namibia.jpg",
            "image_width": "1280",
            "image_height": "960",
            "image_width_on_page": "259",
            "image_height_on_page": "194",
            "date": "Nov 24, 2017",
            "description": "This is a list of estimated global populations of Carnivora species. This list is not ... Tiger, Panthera tigris, 3,890, EN, Decrease, Tigress at Jim Corbett National ...",
            "user_id": 1,
            "list_id": 608,
            "image_id": 4973,
            "search_id": "ZTAzuWH3FUPS6NYQpsPVG6dgha1fui6h",
            "search_image_url": "https://upload.wikimedia.org/wikipedia/commons/7/73/Lion_waiting_in_Namibia.jpg",
            "found_timestamp": "2017-11-27T09:20:24-0500",
            "seen_timestamp": "2017-11-27T09:20:24-0500",
            "debug": {
                "foundOn": 20
            },
            "result_hash": "85d441d7ee36a3ed26d82cb98ec50508"
        }
    }
}


Other powerful endpoints
  • Monitor: We'll search your lists everyday to find new domains and webpages which are using your images.
  • Query: Filter search results with Lucene query syntax to exactly match data to your requirements
  • Notify: We'll notify you by email or a postback request of any new domains found using your images. This enables integration to Slack, JIRA, or your favourite tools via IFTTT or Zapier