Google Images API

	Code examples	Build status
Live testing

To get Google Images results from SerpApi, create a search with:

required tbm parameter must be set to isch. (I.e., tbm=isch)

optional ijn parameter defines the page number to get. It must be an integer greater than or equal to 0.

optional chips parameter enables to filter image search. it's a string provided by Google as suggested search, like: red apple.
chips are provided under the section: suggested_searches when ijn = 0.
both chips value and link to SerpApi is provided for each suggested search.

The images are fetched by batch of 100 images per searches. In order to retrieve the first 300 images, 3 searches would be needed.

As an example, to get the first 300 images for the search "Apple":

SerpApi JSON structure:

{
  ...
   "images_results": [
    {
      "position": Integer - Image index
      "thumbnail": String - Google Thumbnail URL (cache)
      "original": String - Original Image URL (full resolution)
      "title": String - Short Image Description
      "source": String - Original Domain Name 
    },
    "suggested_searches": [
    {
      "name": String - suggested searches name
      "link": String - Google search link original
      "chips": String - Google chips parameter value
      "serpapi_link": String - Link to SerpApi to fetch the suggested searches
      "thumbnail": String - URL or base64 encoded image thumbnail displayed by Google
     },
    ...
  ]
  ...
}

Example: images results for "apple"

JSON response

{
  ...
  "images_results": [
    {
      "position": 1,
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSYfgh6R22EUz-8EUwh-e68sSEFOHWXeZHuysRW_DPkhahMgdwJ",
      "original": "https://www.apple.com/ac/structured-data/images/knowledge_graph_logo.png?201606271147",
      "title": "Buy AirPods - Apple",
      "source": "apple.com"
    },
    {
      "position": 2,
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSMzLN9iUjPiaNdA8w7NtzSTuJI0UPbDFOQKh3IXF6buUYmkaNr",
      "original": "https://as-images.apple.com/is/image/AppleInc/aos/published/images/o/g/og/default/og-default?wid=1200&hei=630&fmt=jpeg&qlt=95&op_usm=0.5,0.5&.v=1525370171638",
      "title": "Buy Mac Accessories - Apple",
      "source": "apple.com"
    },
    {
      "position": 3,
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSrdINKE0Mf9NtmvZqt8GWSwDXjvtFGrRyy1SsO9l-zFyFLoMWg",
      "original": "https://www.apple.com/ac/structured-data/images/open_graph_logo.png?201809210816",
      "title": "Apple",
      "source": "apple.com"
    },
  ...
  ],
  "suggested_searches": [
    {
      "name": "iphone",
      "link": "/search?gl=us&hl=en&tbm=isch&q=Apple&chips=q:apple,g_1:iphone:LwK6Z4lykoM%3D&usg=AI4_-kRkP8Hi1N65SiA0v844lFW1yxlnuA&sa=X&ved=0ahUKEwjGkIHgzqjgAhXywMQHHaEPA-oQ4lYIJigA",
      "chips": "q:apple,g_1:iphone:LwK6Z4lykoM%3D",
      "serpapi_link": "https://serpapi.com/search.json?q=Apple&hl=en&gl=us&device=desktop&tbm=isch&chips=q:apple,g_1:iphone:LwK6Z4lykoM%3D",
      "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKD..."
    },
    {
      "name": "logo",
      "displayed_link": "/search?gl=us&hl=en&tbm=isch&q=Apple&chips=q:apple,g_1:logo:WbchsB1oeiI%3D&usg=AI4_-kQnq2mJ7ny-KCLQcBFnCxO3mHDN8A&sa=X&ved=0ahUKEwjGkIHgzqjgAhXywMQHHaEPA-oQ4lYIKCgB",
      "chips": "q:apple,g_1:logo:WbchsB1oeiI%3D",
      "serpapi_link": "https://serpapi.com/search.json?q=Apple&hl=en&gl=us&device=desktop&tbm=isch&chips=q:apple,g_1:logo:WbchsB1oeiI%3D",
      "thumbnail": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFQAAABUCAMAAAArteDzAAAAZlBMVEUAAAD////n5+eNjY3S0tLHx8f8/Pz09PT5+fne3t7i4uLPz8+lpaVmZmYwMDAoKCh6enpdXV..."
    },
  ...
}

Advanced Filter Search

Google Images provides a way to filter by size, image type, and more. This information is encoded in the tbs parameter. E.g., tbs=itp:photos,isz:l selects only large photos.

SerpApi search examples:

To build your own tbs parameter, you can use the regular Google Images and copy the value of the field tbs from the url:

Enable Tools dropdown on the right
Select the image filters you want to use

Your browser URL should contains somthing like: ...&tbs=itp:photos,isz:l.... You can use this value directly on SerpApi.

Google Images API via SerpApi

Example: images results for "apple"

Advanced Filter Search