Scrapingdog

Google Image Search API

The Google Image Search API lets you retrieve image search results from Google Images including titles, thumbnails, source links, and original dimensions. Each successful request costs 10 API credits.

Endpoint: https://api.scrapingdog.com/google_images

API Parameters

πŸ”‘

Scrapingdog Parameters

  • api_key Required
    Your personal API key. Available on your dashboard

    Type: String
  • html Optional
    This will return the full HTML of the Google Images page.

    Default Value - false

    Type - Boolean
πŸ”

Search Query

  • query Required
    This is a Google Search Query. Example1 - query=pizza

    Type: String
🌍

Geographic Location and Localization

  • domain Optional
    To obtain local results from a specific country, for example, for India, it will be "google.co.in," and for the UK, it will be "google.co.uk". For a complete list of supported domains, see the Google Domains Page.

    Default: google.com

    Type: String
  • country Optional
    This parameter specifies the country for the Google search using a two-letter country code (e.g., US for the United States, UK for the United Kingdom, or FR for France). For a complete list of supported countries, see the Google Country Parameter.

    Default Value - us

    Type - String
  • cr Optional
    The parameter allows you to restrict the search to specific countries. It follows the format country{two-letter uppercase country code} and uses | as a separator for multiple countries. For example, countryFR|countryDE will return results only from French and German websites. For a complete list, see the Google CR Countries Page.

    Type - String
  • uule Optional
    It is a parameter that specifies the geographic location or locale for which the search results should be tailored. Possible Value could be w+CAIQIFJlbGF5IFN0YXRlcw==

    Type - String
  • language Optional
    Language of the results. Possible Values - en, es, fr, de, etc. For a complete list of supported languages, see the Google Language Page.

    Default Value - en

    Type - String
  • lr Optional
    Limit the search to one or multiple languages. It is used as lang_{language code}. For a complete list, see the Google LR Language Page.

    Type - String
⏰

Time Period

  • period_unit Optional
    This parameter specifies the time unit for retrieving recent images, such as the past minute, hour, day, etc.

    Available options:
    • s – Second
    • n – Minute
    • h – Hour
    • d – Day
    • w – Week
    • m – Month
    • y – Year
    ⚠️ Note:
    • This parameter cannot be used alongside start_date and end_date.
    • It takes precedence over the qdr component in the tbs parameter.
    Type - String
  • period_value Optional
    This parameter specifies an optional time duration, used in combination with period_unit to define time intervals such as 15 seconds, 42 hours, or 178 days.

    Details:
    • Default value: 1
    • Valid range: 1 to 2,147,483,647
    Type - String
  • start_date Optional
    This parameter specifies the start date for limiting the image search within a specific time range.

    Details:
    • Format: YYYYMMDD
    • Example: 20241201
    Notes:
    • Cannot be used with period_unit or period_value.
    • If end_date is left blank, the search range will be from start_date to today.
    • Overrides the cdr and cd_min components of the tbs parameter.
    Type - String
  • end_date Optional
    This parameter specifies the end date for restricting the image search within a specific time range.

    Details:
    • Format: YYYYMMDD
    • Example: 20241231
    Notes:
    • Cannot be used with period_unit or period_value.
    • If start_date is left blank, the search range will include all dates before end_date.
    • Overrides the cdr and cd_max components of the tbs parameter.
    Type - String
βš™

️ Advanced Filters

  • chips Optional
    This parameter allows filtering of image search results using a suggested search term provided by Google, such as "red apple."

    Details:
    • Suggested search terms (chips) are available under the suggested_searches section when ijn = 0.
    • Each suggested search includes both chip values and a scrapingdog_link.
    Type - String
  • tbs Optional
    to be searched - An advanced parameter to filter search results.

    Type: String
  • imgar Optional
    This parameter specifies the aspect ratio for filtering images.

    Available options:
    • s – Square
    • t – Tall
    • w – Wide
    • xw – Panoramic
    Type: String
  • imgsz Optional
    This parameter specifies the image size filter.

    Available options:
    • l – Large
    • m – Medium
    • i – Icon
    • qsvga – Larger than 400Γ—300
    • vga – Larger than 640Γ—480
    • svga – Larger than 800Γ—600
    • xga – Larger than 1024Γ—768
    • 2mp – Larger than 2 MP
    • 4mp – Larger than 4 MP
    • 6mp – Larger than 6 MP
    • 8mp – Larger than 8 MP
    • 10mp – Larger than 10 MP
    • 12mp – Larger than 12 MP
    • 15mp – Larger than 15 MP
    • 20mp – Larger than 20 MP
    • 40mp – Larger than 40 MP
    • 70mp – Larger than 70 MP
    Type: String
  • image_color Optional
    This parameter specifies the color filter for images.

    Available options:
    • bw – Black and white
    • trans – Transparent
    • red – Red
    • orange – Orange
    • yellow – Yellow
    • green – Green
    • teal – Teal
    • blue – Blue
    • purple – Purple
    • pink – Pink
    • white – White
    • gray – Gray
    • black – Black
    • brown – Brown
    Notes:
    • This parameter overrides the ic and isc components of the tbs parameter.
    Type: String
  • image_type Optional
    This parameter specifies the type of images to filter.

    Available options:
    • face – Face
    • photo – Photo
    • clipart – Clip art
    • lineart – Line drawing
    • animated – Animated
    Notes:
    • This parameter overrides the itp component of the tbs parameter.
    Type: String
  • licenses Optional
    This parameter specifies the license type for filtering images.

    Available options:
    • f – Free to use or share
    • fc – Free to use or share, even commercially
    • fm – Free to use, share, or modify
    • fmc – Free to use, share, or modify, even commercially
    • cl – Creative Commons licenses
    • ol – Commercial and other licenses
    Notes:
    • This parameter overrides the sur component of the tbs parameter.
    Type: String
  • safe Optional
    To filter the adult content set safe to active or to disable it set off.

    Type: String [active/off]

    Default: off
  • nfpr Optional
    It excludes the result from an auto-corrected query that is spelled wrong. It can be set to 1 to exclude these results or 0 to include them.

    Type: Boolean

    Default: 0
  • filter Optional
    This parameter controls whether the "Similar Results" and "Omitted Results" filters are enabled or disabled. Set it to 1 (default) to activate the filters or 0 to turn them off.

    Type: Boolean
πŸ“„

Pagination

  • page Optional
    This is the page number of Google searches. Its value can be 0 for the first page, 1 for the second page, and so on.

    Default Value - 0

    Type - String

API Examples

Code to Integrate
curl "https://api.scrapingdog.com/google_images?api_key=APIKEY&query=football&country=us"
API Response
{
  "images_results": [
    {
      "title": "File:American football.svg - Wikipedia",
      "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSchgavmZI04Z2kfeeJp_xoLasvhOVA4CvvfA&s",
      "source": "en.m.wikipedia.org",
      "original": "https://upload.wikimedia.org/wikipedia/commons/thumb/1/16/American_football.svg/1024px-American_football.svg.png",
      "link": "https://en.m.wikipedia.org/wiki/File:American_football.svg",
      "original_height": 1024,
      "original_width": 1024,
      "original_size": "167KB",
      "rank": 1
    },
    {
      "title": "the-ball-football.jpg",
      "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTiNAaJQJum6GgYqytfKggAwhRlMCZ2nQMvmA&s",
      "source": "operations.nfl.com",
      "original": "https://operations.nfl.com/media/2948/the-ball-football.jpg",
      "link": "https://operations.nfl.com/learn-the-game/nfl-basics/terms-glossary/",
      "original_height": 663,
      "original_width": 995,
      "original_size": "317KB",
      "rank": 2
    }
  ]
}