Copied to clipboard!

Google Images API

/ Home / Google Search API / Images API

Code examples

Daily build status

To scrape Google Images results with SerpApi, create a search with these parameters:

Name

Required

Description

tbm

Required

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

ijn

Optional

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

chips

Optional

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 overview:

{
  ...
   "images_results": [
    {
      "position": "Integer - Image index",
      "thumbnail": "String - Google Thumbnail URL (cache)",
      "original": "String - Original Image URL (full resolution)",
      "title": "String - Short Image Description",
      "link": "String - Link to the page providing the image",
      "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"
     },
    ...
  ]
  ...
}

Images Results for "Apple"

Google page structure:

Zoom In

SerpApi JSON structure:

{
  ...
  "images_results": [
    {
      "position": 1,
      "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",
      "source": "apple.com",
      "title": "Apple Accessories for Apple Watch, iPhone, iPad, iPod, and Mac - Apple",
      "link": "https://www.apple.com/shop/accessories/all-accessories"
    },
    {
      "position": 2,
      "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",
      "source": "apple.com",
      "title": "Buy AirPods with Wireless Charging Case - Apple",
      "link": "https://www.apple.com/shop/product/MRXJ2AM/A/airpods-with-wireless-charging-case"
    },
    {
      "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",
      "source": "apple.com",
      "title": "Apple",
      "link": "https://www.apple.com/"
    },
  ...
  ],
  "suggested_searches": [
    {
      "name": "iphone",
      "link": "/search?gl=us&hl=en&tbm=isch&q=Apple&chips=q:apple,g_1:iphone:ZQ7UrAOKpgI%3D&usg=AI4_-kTuMNyVIgli_mZusNp6-WVAiWolRA&sa=X&ved=0ahUKEwjz_L3Y7sfhAhXOtVkKHal3CBEQ4lYIJigA",
      "chips": "q:apple,g_1:iphone:ZQ7UrAOKpgI%3D",
      "serpapi_link": "https://serpapi.com/search.json?&location=Austin,Texas,United%20States&q=Apple&domain=google.com&hl=en&gl=us&device=desktop&tbm=isch&chips=q:apple,g_1:iphone:ZQ7UrAOKpgI%253D",
      "thumbnail": null
    },
    {
      "name": "logo",
      "link": "/search?gl=us&hl=en&tbm=isch&q=Apple&chips=q:apple,g_1:logo:jevwK_PM7vk%3D&usg=AI4_-kS5cZPs_-OGHZv4ce-qm7lDCYGIhA&sa=X&ved=0ahUKEwjz_L3Y7sfhAhXOtVkKHal3CBEQ4lYIKCgB",
      "chips": "q:apple,g_1:logo:jevwK_PM7vk%3D",
      "serpapi_link": "https://serpapi.com/search.json?&location=Austin,Texas,United%20States&q=Apple&domain=google.com&hl=en&gl=us&device=desktop&tbm=isch&chips=q:apple,g_1:logo:jevwK_PM7vk%253D",
      "thumbnail": null
    },
  ...
}

Images 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.