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
Default: "google.com"
Type: String
country
Default Value - us
Type - String
cr
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
Default Value - en
Type - String
lr
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 beforeend_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.
<?php
// Set the API key and request parameters
$api_key = '5eaa61a6e562fc52fe763tr516e4653';
$query = 'football';
$results = 10;
$country = 'us';
// Set the API endpoint
$url = 'https://api.scrapingdog.com/google_images/?api_key=' . $api_key . '&query=' . $query . '&results=' . $results . '&country=' . $country;
// Initialize cURL session
$ch = curl_init($url);
// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// Execute the cURL request
$response = curl_exec($ch);
// Check if the request was successful
if ($response === false) {
echo 'cURL error: ' . curl_error($ch);
} else {
// Process the response data as needed
echo $response;
}
// Close the cURL session
curl_close($ch);
require 'net/http'
require 'uri'
# Set the API key and request parameters
api_key = '5eaa61a6e562fc52fe763tr516e4653'
query = 'football'
results = 10
country = 'us'
# Construct the API endpoint URL
url = URI.parse("https://api.scrapingdog.com/google_images/?api_key=#{api_key}&query=#{query}&results=#{results}&country=#{country}")
# Create an HTTP GET request
request = Net::HTTP::Get.new(url)
# Create an HTTP client
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true # Enable SSL (https)
# Send the request and get the response
response = http.request(request)
# Check if the request was successful
if response.is_a?(Net::HTTPSuccess)
puts response.body # Process the response data as needed
else
puts "HTTP request failed with code: #{response.code}, message: #{response.message}"
end
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.IOException;
public class Main {
public static void main(String[] args) {
try {
// Set the API key and request parameters
String apiKey = "5eaa61a6e562fc52fe763tr516e4653";
String query = "football";
int results = 10;
String country = "us";
// Construct the API endpoint URL
String apiUrl = "https://api.scrapingdog.com/google_news/?api_key=" + apiKey
+ "&query=" + query
+ "&results=" + results
+ "&country=" + country
// Create a URL object from the API URL string
URL url = new URL(apiUrl);
// Open a connection to the URL
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
// Set the request method to GET
connection.setRequestMethod("GET");
// Get the response code
int responseCode = connection.getResponseCode();
if (responseCode == 200) {
// Read the response from the connection
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = reader.readLine()) != null) {
response.append(inputLine);
}
reader.close();
// Process the response data as needed
System.out.println(response.toString());
} else {
System.out.println("HTTP request failed with response code: " + responseCode);
}
// Close the connection
connection.disconnect();
} catch (IOException e) {
e.printStackTrace();
}
}
}
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 .
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 .
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 for a complete list of supported countries.
Language of the results. Possible Values - en, es, fr, de, etc. Visit for a complete list of supported countries.
Limit the search to one or multiple languages. It is used as lang_{language code}. Visit for a complete list of supported countries.
