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

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

Python

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}")

Node JS

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

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

Ruby

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

Java

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