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
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
query
required
This is a Google Search Query. Example1 - query=pizza
Type: String
Geographic Location and Localization
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
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
andend_date
.It takes precedence over the
qdr
component in thetbs
parameter.
Type - String
period_value
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
orperiod_value
.If
end_date
is left blank, the search range will be fromstart_date
to today.Overrides the
cdr
andcd_min
components of thetbs
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
orperiod_value
.If
start_date
is left blank, the search range will include all dates beforeend_date
.Overrides the
cdr
andcd_max
components of thetbs
parameter.
Type - String
Advanced Filters
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 whenijn = 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
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
andisc
components of thetbs
parameter.
Type: String
image_type
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 thetbs
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
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
Response
Last updated