Google Images Search API

prod-global

GET

/api/v1/google/images/search

API health status

Healthy Available Limited Mostly unavailable No data

Loading health status...

Get Google images Search data, including image URLs and metadata, for filtered image discovery for research and monitoring workflows.

Tags: Google Images

Parameters

Name	Required	Type	Default	Description
query	Yes	string		The search query for images (e.g., 'mountain landscape', 'luxury cars').
html	No	boolean	false	Set to true to return the raw HTML of the Google search results page alongside the structured data.
page	No	integer	0	The results page number. Use 0 for the first page, 1 for the second, and so on.
domain	No	string	google.com	The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See Google Domains.
country	No	string	us	Set the target country code (e.g., 'us', 'uk') to localize results. See Google Countries.
cr	No	string		Limits results to search results from specific countries. Format: 'countryXX'. See Google CR Countries.
language	No	string	en	Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language.
lr	No	string		Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Language.
uule	No	string		Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it.
period_unit	No	string		Time unit for 'recent' image results. Supported values: 's' (Second), 'n' (Minute), 'h' (Hour), 'd' (Day), 'w' (Week), 'm' (Month), 'y' (Year).
period_value	No	string		Time duration value used with 'period_unit' (e.g., 15 for 15 days). Default: 1.
start_date	No	string		Start date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241201').
end_date	No	string		End date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241231').
chips	No	string		Additional suggested search terms (chips) to filter images. Values are obtained from previous responses.
tbs	No	string		Advanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty.
imgar	No	string		Filter by image aspect ratio. Supported values: 's' (Square), 't' (Tall), 'w' (Wide), 'xw' (Panoramic).
imgsz	No	string		Filter by image size. Supported values: 'l' (Large), 'm' (Medium), 'i' (Icon), and specific resolutions like '4mp', '10mp'.
image_color	No	string		Filter images by a dominant color (e.g., 'red', 'blue', 'bw' for black and white, 'trans' for transparent).
image_type	No	string		Filter by image type. Supported values: 'face', 'photo', 'clipart', 'lineart', 'animated'.
licenses	No	string		Filter by usage rights and licenses. Supported values: 'f' (Free to use), 'fc' (Commercial use), 'cl' (Creative Commons).
safe	No	string	off	SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it.
nfpr	No	string	0	Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them.
filter	No	string		Toggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disable.

Copy Request

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/images/search?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/images/search?query=coffee", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://api.justserpapi.com/api/v1/google/images/search"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

PHP

<?php
$url = "https://api.justserpapi.com/api/v1/google/images/search?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/images/search?query=coffee", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Response

Loading the latest response example...