Google Images Поиск API

prod-global

GET

/api/v1/google/images/search

Статус API

Исправен Доступен Ограничен Почти недоступен Нет данных

Загрузка статуса...

Получите данные поиска изображений Google, включая URL-адреса изображений и метаданные, для фильтрованного поиска изображений в исследовательских и мониторинговых рабочих процессах.

Теги: Google Images

Параметры

Имя	Обязательный	Тип	По умолчанию	Описание
query	Да	string		Поисковый запрос для изображений (например, 'горный пейзаж', 'роскошные автомобили').
html	Нет	boolean	false	Установите значение true, чтобы вернуть необработанный HTML страницы результатов поиска Google вместе со структурированными данными.
page	Нет	integer	0	Номер страницы результатов. Используйте 0 для первой страницы, 1 для второй и так далее.
domain	Нет	string	google.com	Домен Google для поиска (например, 'google.com', 'google.co.uk'). См. Google Domains.
country	Нет	string	us	Установите код целевой страны (например, 'us', 'uk') для локализации результатов. См. Google Countries.
cr	Нет	string		Ограничивает результаты поиска из определенных стран. Формат: 'countryXX'. См. Google CR Countries.
language	Нет	string	en	Установите язык результатов, используя его двухбуквенный код (например, 'en' для английского, 'fr' для французского). См. Google Language.
lr	Нет	string		Ограничьте результаты одним или несколькими языками, используя формат 'lang_{код_языка}' (например, 'lang_en'). См. Google LR Language.
uule	Нет	string		Закодированная строка местоположения (UULE), используемая для точной локализации результатов поиска Google. Это продвинутый/технический параметр — если вы с ним не знакомы, можете оставить его пустым и не указывать.
period_unit	Нет	string		Единица времени для недавних результатов изображений. Доступные значения: - SECOND: Секунда. Устаревшее значение s также принимается. - MINUTE: Минута. Устаревшее значение n также принимается. - HOUR: Час. Устаревшее значение h также принимается. - DAY: День. Устаревшее значение d также принимается. - WEEK: Неделя. Устаревшее значение w также принимается. - MONTH: Месяц. Устаревшее значение m также принимается. - YEAR: Год. Устаревшее значение y также принимается.
period_value	Нет	string		Значение продолжительности времени, используемое с 'period_unit' (например, 15 для 15 дней). По умолчанию: 1.
start_date	Нет	string		Дата начала для ограничения изображений временным диапазоном. Формат: 'YYYYMMDD' (например, '20241201').
end_date	Нет	string		Дата окончания для ограничения изображений временным диапазоном. Формат: 'YYYYMMDD' (например, '20241231').
chips	Нет	string		Дополнительные предлагаемые поисковые запросы (чипсы) для фильтрации изображений. Значения берутся из предыдущих ответов.
tbs	Нет	string		Параметр расширенного фильтра поиска (tbs), используемый для применения фильтров результатов Google (например, временной диапазон). Это продвинутый параметр — если вы с ним не знакомы, можете оставить его пустым.
imgar	Нет	string		Фильтр по соотношению сторон изображения. Доступные значения: - SQUARE: Квадратные изображения. Устаревшее значение s также принимается. - TALL: Высокие изображения. Устаревшее значение t также принимается. - WIDE: Широкие изображения. Устаревшее значение w также принимается. - PANORAMIC: Панорамные изображения. Устаревшее значение xw также принимается.
imgsz	Нет	string		Фильтр по размеру изображения. Доступные значения: - LARGE: Большие изображения. Устаревшее значение l также принимается. - MEDIUM: Средние изображения. Устаревшее значение m также принимается. - ICON: Иконки. Устаревшее значение i также принимается.
image_color	Нет	string		Фильтр изображений по доминирующему цвету (например, 'red', 'blue', 'bw' для черно-белых, 'trans' для прозрачных).
image_type	Нет	string		Фильтр по типу изображения. Поддерживаемые значения: 'face', 'photo', 'clipart', 'lineart', 'animated'.
licenses	Нет	string		Фильтр по правам использования и лицензиям. Доступные значения: - FREE_TO_USE: Бесплатное использование. Устаревшее значение f также принимается. - COMMERCIAL_USE: Коммерческое использование. Устаревшее значение fc также принимается. - CREATIVE_COMMONS: Creative Commons. Устаревшее значение cl также принимается.
safe	Нет	string	OFF	Настройка фильтра SafeSearch. Доступные значения: - ACTIVE: Фильтровать контент для взрослых. Также принимается устаревшее значение active. - OFF: Отключить фильтрацию SafeSearch. Также принимается устаревшее значение off.
nfpr	Нет	string	INCLUDE_CORRECTED_RESULTS	Управляет автокоррекцией Google. Доступные значения: - INCLUDE_CORRECTED_RESULTS: Включать исправленные результаты. Также принимается устаревшее значение 0. - EXCLUDE_CORRECTED_RESULTS: Исключать исправленные результаты. Также принимается устаревшее значение 1.
filter	Нет	string		Переключение фильтрации похожих и пропущенных результатов. Доступные значения: - DISABLED: Отключить фильтрацию похожих и пропущенных результатов. Устаревшее значение 0 также принимается. - ENABLED: Включить фильтрацию похожих и пропущенных результатов. Устаревшее значение 1 также принимается.

Скопировать запрос

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

Ответ

Загрузка последнего примера ответа...