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 10 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

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

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"

import requests

api_key = "5eaa61a6e562fc52fe763tr516e4653"
url = "https://api.scrapingdog.com/google_images"

params = {
    "api_key": api_key,
    "query": "football",
    "results": 10,
    "country": "us"
}

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Request failed with status code: {response.status_code}")

const axios = require('axios');

const api_key = '5eaa61a6e562fc52fe763tr516e4653';
const url = 'https://api.scrapingdog.com/google_images';

const params = {
  api_key: api_key,
  query: 'football',
  results: 10,
  country: 'us'
};

axios
  .get(url, { params: params })
  .then(function (response) {
    if (response.status === 200) {
      const data = response.data;
      console.log(data)
    } else {
      console.log('Request failed with status code: ' + response.status);
    }
  })
  .catch(function (error) {
    console.error('Error making the request: ' + error.message);
  });

<?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();
        }
    }
}

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
        }
    ]
}

PreviousGoogle Trends Locations NextGoogle News API

Last updated 5 months ago