Google Images Scraper API is a tool that allows users to extract images from Google Images search results in a structured format. The API returns a HTML or JSON object that contains the search results and additional metadata about the search or CSV.

HTML

JSON Example

{
  "request_info" : {
    "success" : true,
    "monthly_credits_limit" : 80000,
    "monthly_credits_remaining" : 62734,
    "monthly_credits_reset_at" : "2023-05-03T06:40:06.000Z",
    "topup_credits_remaining" : 0,
    "credits_decremented_from" : "monthly_credits",
    "credits_used_this_request" : 1
  },
  "search_parameters" : {
    "q" : "chocolate%20milk",
    "google_domain" : "google.com",
    "gl" : "us",
    "hl" : "en",
    "images_color" : "purple",
    "search_type" : "images",
    "engine" : "google"
  },
  "search_metadata" : {
    "created_at" : "2023-04-10T13:08:06.049Z",
    "processed_at" : "2023-04-10T13:08:08.734Z",
    "total_time_taken" : 2.69,
    "engine_url" : "https://www.google.com/search?q=chocolate%2520milk&gl=us&hl=en&tbm=isch&tbs=ic%3Aspecific%2Cisc%3Apurple",
    "html_url" : "https://app.scrapein.app/api/v1/google/images?q=chocolate%2520milk&google_domain=google.com&gl=us&hl=en&images_color=purple&api_key={API-KEY}&search_type=images&engine=google&output=html\n",
    "json_url" : "https://app.scrapein.app/api/v1/google/images?q=chocolate%2520milk&google_domain=google.com&gl=us&hl=en&images_color=purple&api_key={API-KEY}&search_type=images&engine=google&output=json"
  },
  "search_information" : {
    "original_query_yields_zero_results" : false,
    "query_displayed" : "chocolate%20milk"
  },
  "top_carousel" : {
    "items" : [
      {
        "title" : "milka",
        "link" : "https://www.google.com/search?q=chocolate%2520milk&tbm=isch&hl=en&gl=us&chips=q:chocolate+20milk,online_chips:milka:pJA9LrY-18g%3D&sa=X&ved=2ahUKEwjW89WGsZ_-AhWTuyoKHWCWByoQ4lYoAHoECAEQLA",
        "block_position" : -1
      },
      {
        "title" : "caramel nibbles",
        "link" : "https://www.google.com/search?q=chocolate%2520milk&tbm=isch&hl=en&gl=us&chips=q:chocolate+20milk,online_chips:caramel+nibbles:FLjtpZrnHo0%3D&sa=X&ved=2ahUKEwjW89WGsZ_-AhWTuyoKHWCWByoQ4lYoAXoECAEQLg",
        "block_position" : -1
      },
      {
        "title" : "cadbury chocolate",
        "link" : "https://www.google.com/search?q=chocolate%2520milk&tbm=isch&hl=en&gl=us&chips=q:chocolate+20milk,online_chips:cadbury+chocolate:gcXeshg-7e0%3D&sa=X&ved=2ahUKEwjW89WGsZ_-AhWTuyoKHWCWByoQ4lYoDHoECAEQQQ",
        "block_position" : -1
      }
    ]
  },
  "image_results" : [
    {
      "position" : 1,
      "title" : "bag Of Maccabees\", 20 Milk Chocolate Maccabees/bag – ahuva.com",
      "link" : "https://ahuva.com/products/bag-of-maccabees-20-milk-chocolate-maccabeesbag",
      "domain" : "ahuva.com",
      "width" : 720,
      "height" : 720,
      "image" : "https://cdn.shopify.com/s/files/1/1789/4911/products/bag-of-maccabees-20-milk-chocolate-maccabeesbag-chanukah-508644.jpg?v=1634697996&width=720",
      "name" : "Ahuva"
    },
    {
      "position" : 100,
      "title" : "Buy Cadbury Fuse Fuse Fit Snack Bar, 40 g + Fuse Fit Snack Bar, 41 g + Fuse  Chocolate Bar, 48 g Online at Best Price of Rs 135 - bigbasket",
      "link" : "https://www.bigbasket.com/pd/1219029/cadbury-fuse-fit-snack-bar-40-g-fuse-fit-snack-bar-41-g-fuse-chocolate-bar-48-g-combo/",
      "domain" : "www.bigbasket.com",
      "width" : 300,
      "height" : 300,
      "image" : "https://www.bigbasket.com/media/uploads/p/m/1219029-3_1-cadbury-fuse-fit-snack-bar-40-g-fuse-fit-snack-bar-41-g-fuse-chocolate-bar-48-g.jpg",
      "name" : "BigBasket"
    }
  ]
}

JSON Structure

The JSON structure returned by the Google Images Scraper API includes required elements, such as request_info, search_parameters, search_metadata, search_information, as described in the Results SERP Google API section, as well as those specific to Google Images, which are described below.

top_carousel

The top_carousel - contains information about the top carousel of search results, including:

category: the category or title of the top carousel, if one is shown
items: an array of search results in the top carousel, where each item has a title, subtitle, link, and block_position parameter

image_results

The image_results - contains an array of search results for the image search, where each search result has the following parameters:

position: the position of the image result in the overall search results
title: the title of the image result
link: the link to the image result
domain: the domain of the website hosting the image
width: the width of the image in pixels
height: the height of the image in pixels
image: the URL of the image or a Base64-encoded image
name: the brand name of the image result