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. Available Values: - SECOND: Second. Legacy value s is also accepted. - MINUTE: Minute. Legacy value n is also accepted. - HOUR: Hour. Legacy value h is also accepted. - DAY: Day. Legacy value d is also accepted. - WEEK: Week. Legacy value w is also accepted. - MONTH: Month. Legacy value m is also accepted. - YEAR: Year. Legacy value y is also accepted.
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. Available Values: - SQUARE: Square images. Legacy value s is also accepted. - TALL: Tall images. Legacy value t is also accepted. - WIDE: Wide images. Legacy value w is also accepted. - PANORAMIC: Panoramic images. Legacy value xw is also accepted.
imgsz	No	string		Filter by image size. Available Values: - LARGE: Large images. Legacy value l is also accepted. - MEDIUM: Medium images. Legacy value m is also accepted. - ICON: Icon-sized images. Legacy value i is also accepted.
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. Available Values: - FREE_TO_USE: Free to use. Legacy value f is also accepted. - COMMERCIAL_USE: Commercial use. Legacy value fc is also accepted. - CREATIVE_COMMONS: Creative Commons. Legacy value cl is also accepted.
safe	No	string	OFF	SafeSearch filter setting. Available Values: - ACTIVE: Filter adult content. Legacy value active is also accepted. - OFF: Disable SafeSearch filtering. Legacy value off is also accepted.
nfpr	No	string	INCLUDE_CORRECTED_RESULTS	Controls Google's auto-correction. Available Values: - INCLUDE_CORRECTED_RESULTS: Include corrected results. Legacy value 0 is also accepted. - EXCLUDE_CORRECTED_RESULTS: Exclude corrected results. Legacy value 1 is also accepted.
filter	No	string		Toggle similar-results and omitted-results filtering. Available Values: - DISABLED: Disable similar and omitted results filtering. Legacy value 0 is also accepted. - ENABLED: Enable similar and omitted results filtering. Legacy value 1 is also accepted.

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