Google Images API

Using Google Search API you can scrape Google Image results without worrying about proxy rotation and data parsing. Our API is fast and reliable.

Each successful request will cost you 5 API credits.

You have to send a GET request to http://api.scrapingdog.com/google_images with the below-given parameters.

Google Images API pricing is available here.

Parameters

Scrapingdog Parameters

Parameter
Description

api_key

required

Your personal API key. Available on your dashboard Type: String

html

This will return the full HTML of the Google Images page. Default Value - false Type - Boolean

Search Query

Parameter
Description

query

required

This is a Google Search Query. Example1 - query=pizza Type: String

Geographic Location and Localization

Parameter
Description

domain

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, visit the Google domains page.

Default: "google.com"

Type: String

country

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, visit the Google countries page.

Default Value - us

Type - String

cr

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. Visit Google's cr country-specific page for a complete list of supported countries.

Type - String

uule

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

Language of the results. Possible Values - en, es, fr, de, etc. Visit Google's languages page for a complete list of supported countries.

Default Value - en

Type - String

lr

Limit the search to one or multiple languages. It is used as lang_{language code}. Visit Google's lr languages page for a complete list of supported countries.

Type - String

Time Period

Parameter
Description

period_unit

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

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

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

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

Parameter
Description

chips

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

to be searched - An advanced parameter to filter search results. Type: String

imgar

This parameter specifies the aspect ratio for filtering images.

Available options:

  • s – Square

  • t – Tall

  • w – Wide

  • xw – Panoramic

Type: String

imgsz

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

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

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

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

To filter the adult content set safe to active or to disable it set off. Type: String [active/off]

Default: off

nfpr

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

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

Parameter
Description

page

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 Example

curl "https://api.scrapingdog.com/google_images/?api_key=5eaa61a6e562fc52fe763tr516e4653&query=football&results=10&country=us"

Response

{
    "time_taken": 685.692823,
    "ads": [],
    "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",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_wEVAOr_ChMI_92m-LjRqpAMEMn_weydocs300hofxUAAAA%3D&q=https://en.m.wikipedia.org/wiki/File:American_football.svg&ctx=iv&hl=en-US",
            "is_product": false,
            "rank": 1
        },
        {
            "title": "the-ball-football.jpg?mode=max&width=995",
            "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?mode=max&width=995",
            "link": "https://operations.nfl.com/learn-the-game/nfl-basics/terms-glossary/glossary-terms-list/wilson/",
            "original_height": 663,
            "original_width": 995,
            "original_size": "317KB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_wEXAOj_ChUI1YT0lqvdxMJQEOnytc_MxsOusQFKeigrFwAAAA%3D%3D&q=https://operations.nfl.com/learn-the-game/nfl-basics/terms-glossary/glossary-terms-list/wilson/&ctx=iv&hl=en-US",
            "is_product": false,
            "rank": 2
        },
        {
            "title": "NIKE All Field 3.0 FB 9 Official Single Brown/White/Metallic Silver/Black  Football Ball",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTG0QJMG0-SkvHLvbTq1728C2ShbFTSlOsfaA&s",
            "source": "www.amazon.com",
            "original": "https://m.media-amazon.com/images/I/61BYcXWqhwL._AC_UF1000,1000_QL80_.jpg",
            "link": "https://www.amazon.com/Nike-All-Field-Official-Size-Football/dp/B076DFMSFF",
            "original_height": 628,
            "original_width": 1000,
            "original_size": "130KB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_wEXAOj_ChUIhIbCuNqu-977ARC4_bSt-LLe-zp14LN8FwAAAA%3D%3D&q=https://www.amazon.com/Nike-All-Field-Official-Size-Football/dp/B076DFMSFF&ctx=iv&hl=en-US",
            "is_product": true,
            "rank": 3
        },
        {
            "title": "National Football League (NFL) | History, Teams, & Facts | Britannica",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXL8kG03B7RWEB5Nz47ZkrSytbys6UwekUzg&s",
            "source": "www.britannica.com",
            "original": "https://cdn.britannica.com/30/249830-050-63E9E776/Baltimore-Ravens-quarterback-Lamar-Jackson-2018.jpg",
            "link": "https://www.britannica.com/topic/National-Football-League",
            "original_height": 1028,
            "original_width": 1600,
            "original_size": "222KB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_wEXAOj_ChUIsLu0kNz00ProARClj7PeqryQ6iwpetpxFwAAAA%3D%3D&q=https://www.britannica.com/topic/National-Football-League&ctx=iv&hl=en-US",
            "is_product": false,
            "rank": 4
        },
        {
            "title": "Wilson NCAA Red Zone Composite Football, Official Size (Ages 14 and up)",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-rvfxgo7-4ciLut2abrSkOjbNcQFfnbCWlA&s",
            "source": "www.walmart.com",
            "original": "https://i5.walmartimages.com/seo/Wilson-NCAA-Red-Zone-Composite-Football-Official-Size-Ages-14-and-up_378a9879-6283-4f98-aa42-3d73a49f07da.0d3133fab0afccadc68fa3bf61e75062.jpeg",
            "link": "https://www.walmart.com/ip/Wilson-NCAA-Red-Zone-Composite-Football-Official-Size-Ages-14-and-up/17165318",
            "original_height": 2200,
            "original_width": 2200,
            "original_size": "624KB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_-MS5Wi5_Pja9oYnLUYCJ2586-z9cf5vDyMA0MdhmRcAAAA%3D&q=https://www.walmart.com/ip/Wilson-NCAA-Red-Zone-Composite-Football-Official-Size-Ages-14-and-up/17165318&ctx=iv&hl=en-US",
            "is_product": true,
            "rank": 5
        },
        {
            "title": "American Football Official Size Football Recreational Play Ball Gift,  Sports Football Competition Ball for Playing",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRfsI1V0a9WaZMdUVVivi1Y0urxXwOdrE8qFg&s",
            "source": "www.amazon.com",
            "original": "https://m.media-amazon.com/images/I/61ceQO+CuVL._AC_UF1000,1000_QL80_.jpg",
            "link": "https://www.amazon.com/Colaxi-American-Football-Recreational-Competition/dp/B0D3VPY3KM",
            "original_height": 697,
            "original_width": 1000,
            "original_size": "65KB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_wEWAOn_ChQIovDCzvH0uMk2EJHJ567myLf-WhvGPusWAAAA&q=https://www.amazon.com/Colaxi-American-Football-Recreational-Competition/dp/B0D3VPY3KM&ctx=iv&hl=en-US",
            "is_product": true,
            "rank": 6
        },
        {
            "title": "Wilson NFL Prestige Composite Football, Junior Size (Ages 9-12)",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSTEzyY9DtP7q1ADvvzpJnQGonHztD-Tc6Mgg&s",
            "source": "www.walmart.com",
            "original": "https://i5.walmartimages.com/seo/Wilson-NFL-Prestige-Football-JR_b9eae896-2b55-4cf6-9538-21b1645e39c0.a7a400c558e3303c155827e184bb4c76.png?odnHeight=768&odnWidth=768&odnBg=FFFFFF",
            "link": "https://www.walmart.com/ip/Wilson-NFL-Prestige-Football-JR/5605355049",
            "original_height": 768,
            "original_width": 768,
            "original_size": "88KB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_-MS5VjztWXu7Ht_Z3QwCpw78H9j250Tr30BwVC-0BcAAAA%3D&q=https://www.walmart.com/ip/Wilson-NFL-Prestige-Football-JR/5605355049&ctx=iv&hl=en-US",
            "is_product": true,
            "rank": 7
        },
        {
            "title": "The Man Who “Completed Football” | The New Yorker",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQZId782c6RFWPYky-DM5TW47RT5V1ji3-HKg&s",
            "source": "www.newyorker.com",
            "original": "https://media.newyorker.com/photos/6543f23235570d74bd3ef32e/1:1/w_1706,h_1706,c_limit/Akam-Pelly%20Ruddock%20Mpanzu.jpg",
            "link": "https://www.newyorker.com/sports/sporting-scene/the-man-who-completed-football",
            "original_height": 1706,
            "original_width": 1706,
            "original_size": "433KB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_-MS5fgx_93W9nOrD81gFNi_f_Ok3unrWvIBzVzLVRcAAAA%3D&q=https://www.newyorker.com/sports/sporting-scene/the-man-who-completed-football&ctx=iv&hl=en-US",
            "is_product": false,
            "rank": 8
        },
        {
            "title": "500+ American Football Pictures [HQ] | Download Free Images on Unsplash",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT0c0f5VGJ7P2ILgkS9tizWKWH9jwpfUjz6lA&s",
            "source": "unsplash.com",
            "original": "https://images.unsplash.com/photo-1566577739112-5180d4bf9390?fm=jpg&q=60&w=3000&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8Mnx8YW1lcmljYW4lMjBmb290YmFsbHxlbnwwfHwwfHx8MA%3D%3D",
            "link": "https://unsplash.com/s/photos/american-football",
            "original_height": 2400,
            "original_width": 3000,
            "original_size": "1.2MB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_-MS5dh-dtWpb3uv_v3KKNCxavrn_lcdPcYADfNuBxcAAAA%3D&q=https://unsplash.com/s/photos/american-football&ctx=iv&hl=en-US",
            "is_product": false,
            "rank": 9
        },
        {
            "title": "College football bowl games today: Schedule features five matchups",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRFDqYe00RHhwDhcepGXXCpkahATHZ63D4_vA&s",
            "source": "www.usatoday.com",
            "original": "https://www.usatoday.com/gcdn/authoring/authoring-images/2024/09/12/USAT/75192359007-usatsi-24181090.jpg?crop=3454,3454,x762,y0",
            "link": "https://www.usatoday.com/story/sports/ncaaf/2024/12/31/what-college-football-bowl-games-are-today-dec-31/77332259007/",
            "original_height": 3454,
            "original_width": 3454,
            "original_size": "1.6MB",
            "know_more_link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAA_wEXAOj_ChUIlbfc28ig65GDARC3vJq00NGtiHqP7rQjFwAAAA%3D%3D&q=https://www.usatoday.com/story/sports/ncaaf/2024/12/31/what-college-football-bowl-games-are-today-dec-31/77332259007/&ctx=iv&hl=en-US",
            "is_product": false,
            "rank": 10
        }
    ]
}

Last updated