# Google Images API Here is the list of default parameters for this API :\

Parameters	Description
api_key required	This is your API key.
q required	Type: `String` Google Search Query
gl	Type: `String` Default: `"us"` Name of the country. The name should be in ISO 3166 Alpha-2 format.
domain	Type: `String` Default: `"google.com"` 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."
hl	Type: `String` Default: `"en_us"` The language of the requested results.
ijn	Type: `Number(Integer)` `[0,1,2....]` Default: `0` (Enter 1 for 2nd-page results, 2 for 3rd, etc .) The page number to get targeted search results.
lr	Type: `String` Limit the search to one or multiple languages. It is used as `lang_{language code}`. For example - "lang_us".
uule	Type: `String` Used to encode a place an exact location(with latitude and longitude) into a value used in a cookie, an URL, or an HTTP header.
duration	Type: `String` Use this as `"d/w/m/mn/y"` where n is from `0-10`. `d` - the previous 24 hours, `w` - the previous seven days, `m` - the previous month, `mn` - the previous n number of months, `y` - past year The `duration` parameter requests search results from a specified time period (quick date range).
nfpr	Type: `Boolean` Default: `0` 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.
tbs	Type: `String` to be searched - An advanced parameter to filter search results.
chips	Type: `String` Used to filter image results. They are provided under the section `suggested_searches` when `ijn = 0`.
safe	Type: String `[active/off]` Default: `off` To filter the adult content set `safe` to `active` or to disable it set it `off`.
html	Type: `Boolean` Default: `false` To render response as raw HTML.

### Some relevant tbs parameters for the Google Images API | TBS | Parameters | | :-----------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | Size |

tbs = size:l
l - for large-sized images
tbs = size:m
m - for medium-sized images
tbs = size:i
i - for icon-sized images

| | Images of specific color |

tbs=ic:specific,isc:color

color = \[orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown]

| | Creative Common licenses images | `tbs=il:cl` | | Commercial and other licenses | `tbs=il:ol` | ### API Example: {% tabs %} {% tab title="cURL" %} ```json cURL "https://api.serpdog.io/images?api_key=APIKEY&q=football&gl=us" ``` {% endtab %} {% tab title="Node JS" %} ```javascript const axios = require('axios'); axios.get('https://api.serpdog.io/images?api_key=APIKEY&q=football&gl=us') .then(response => { console.log(response.data); }) .catch(error => { console.log(error); }); ``` {% endtab %} {% tab title="Python" %} ```python import requests payload = {'api_key': 'APIKEY', 'q':'football', 'gl' : 'us'} resp = requests.get('https://api.scrapingdog.io/google', params=payload) print (resp.text) ``` {% endtab %} {% tab title="Java" %} ```java try { String apiKey = "APIKEY"; String url = "https://api.serpdog.io/images?api_key=APIKEY&q=football&gl=us"; URL urlForGetRequest = new URL(url); String readLine = null; HttpURLConnection conection = (HttpURLConnection) urlForGetRequest.openConnection(); conection.setRequestMethod("GET"); int responseCode = conection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { BufferedReader in = new BufferedReader(new InputStreamReader(conection.getInputStream())); StringBuffer response = new StringBuffer(); while ((readLine = in.readLine()) != null) { response.append(readLine); } in.close(); System.out.println(response.toString()); } else { throw new Exception("Error in API Call"); } } catch (Exception ex) { ex.printStackTrace(); } ``` {% endtab %} {% tab title="Ruby" %} ```ruby require 'net/http' require 'json' params = { :api_key => "APIKEY", :q => "football", :gl => "us" } uri = URI('https://api.serpdog.io/images') uri.query = URI.encode_www_form(params) website_content = Net::HTTP.get(uri) print(website_content) ``` {% endtab %} {% tab title="PHP" %} ```php ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.