×

Image Search API documentation

How to use the Image Search API

Image Search API is a simple HTTP REST API for searching and retrieving images from all over the web. The Image Search API allows you to integrate image search capabilities in your applications. By sending user search queries with the API, you can get and display relevant and high-quality images similar to ContextualWeb Image Search API.

While the ContextualWeb Image Search API provides image-only search results, you can combine or use ContextualWeb News API and Web API.

Header Parameters:

X-RapidAPI-HostStringcontextualwebsearch-websearch-v1.p.rapidapi.com
X-RapidAPI-KeyStringGet API Key

Required parameters:

qStringThe user's search query string
pageNumberNumberThe page to view
pageSizeNumberThe number of items per page. The maximum value is 50
autoCorrectBooleanAutomatically correct spelling
safeSearchBooleanFilter results for adult content

Response 200:

{
  "_type": "images",
  "value": [
    {
      "url": "https://dressupwho.net/i-files/thumb_1/20610-donald-trump-vs-hillary-clinton-70x175.jpg",
      "height": 175,
      "width": 70,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=6446573495239113800",
      "thumbnailHeight": 400,
      "thumbnailWidth": 160,
      "base64Encoding": null
    },
    {
      "url": "http://games.dressuppink.com/images/donald-trump-vs-hillary-clinton.jpg?t9tad7",
      "height": 60,
      "width": 80,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=8187980894059393231",
      "thumbnailHeight": 210,
      "thumbnailWidth": 280,
      "base64Encoding": null
    },
    {
      "url": "https://pmcdeadline2.files.wordpress.com/2018/08/donald-trump-2.jpg?w=605",
      "height": 403,
      "width": 605,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=6250921748791014870",
      "thumbnailHeight": 173,
      "thumbnailWidth": 260,
      "base64Encoding": null
    },
    {
      "url": "http://www.india.com/wp-content/uploads/2018/08/donald-trump.jpg",
      "height": 415,
      "width": 700,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=8531529161775551633",
      "thumbnailHeight": 237,
      "thumbnailWidth": 400,
      "base64Encoding": null
    },
    {
      "url": "https://cdn.dnaindia.com/sites/default/files/styles/full/public/2018/08/28/723845-660810-trumpdonald-afp-031518.jpg",
      "height": 720,
      "width": 1280,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=3621691658002374059",
      "thumbnailHeight": 157,
      "thumbnailWidth": 280,
      "base64Encoding": null
    },
    {
      "url": "http://projects.thestar.com/donald-trump-fact-check/images/trumpcheck-02.jpg",
      "height": 391,
      "width": 800,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=8672178186432489387",
      "thumbnailHeight": 127,
      "thumbnailWidth": 260,
      "base64Encoding": null
    },
    {
      "url": "http://a57.foxnews.com/images.foxnews.com/content/fox-news/entertainment/2018/08/28/snl-star-pete-davidson-recalls-working-with-psycho-donald-trump-and-his-bad-audition-to-portray-him/_jcr_content/par/featured_image/media-0.img.jpg/0/0/1535481722723.jpg?ve=1",
      "height": 720,
      "width": 1280,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=7252629321769597480",
      "thumbnailHeight": 191,
      "thumbnailWidth": 340,
      "base64Encoding": null
    },
    {
      "url": "https://sportshub.cbsistatic.com/i/r/2018/08/28/c9026af8-8d09-4d1b-9c5a-67e082693152/thumbnail/770x433/d62e243ababa261dfcbd28248ed83980/donald-trump-gianni-infantino.jpg",
      "height": 433,
      "width": 770,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=5708997472337713695",
      "thumbnailHeight": 157,
      "thumbnailWidth": 280,
      "base64Encoding": null
    },
    {
      "url": "https://images.thestar.com/4683apHlx2GybGKlNQfrEOIzK6w=/1200x799/smart/filters:cb(1534514539753)/https://www.thestar.com/content/dam/thestar/news/world/2018/08/17/donald-trump-cancels-ridiculously-expensive-military-parade/trumpmilitary.jpg",
      "height": 799,
      "width": 1200,
      "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=3802727927775564525",
      "thumbnailHeight": 159,
      "thumbnailWidth": 240,
      "base64Encoding": null
    }
  ]
} 

Schema:

{
  "type": "object",
  "properties": {
    "_type": {
      "type": "string"
    },
    "value": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "height": {
            "type": "integer"
          },
          "width": {
            "type": "integer"
          },
          "thumbnail": {
            "type": "string",
            "format": "uri"
          },
          "thumbnailHeight": {
            "type": "integer"
          },
          "thumbnailWidth": {
            "type": "integer"
          },
          "base64Encoding": {
            "type": "null"
          }
        }
      }
    }
  }
}