Google 图片 搜索 API

prod-global

GET

/api/v1/google/images/search

API 健康状态

健康 可用 受限 大多不可用 无数据

正在加载健康状态...

获取 Google 图片搜索数据，包括图片 URL 和元数据，用于过滤后的图片发现，适用于研究和监控工作流程。

标签: Google 图片

请求参数

名称	必填	类型	默认值	说明
query	是	string		图片的搜索查询（例如 '山景'、'豪车'）。
html	否	boolean	false	设置为 true 以返回 Google 搜索结果页面的原始 HTML 以及结构化数据。
page	否	integer	0	结果页码。使用 0 表示第一页，1 表示第二页，依此类推。
domain	否	string	google.com	用于搜索的 Google 域名（例如 'google.com'、'google.co.uk'）。请参阅 Google 域名。
country	否	string	us	设置目标国家代码（例如 'us'、'uk'）以本地化结果。请参阅 Google 国家/地区。
cr	否	string		将结果限制为特定国家的搜索结果。格式：'countryXX'。参见 Google CR 国家/地区。
language	否	string	en	使用其两位字母代码设置结果语言（例如 'en' 表示英语，'fr' 表示法语）。请参阅 Google 语言。
lr	否	string		使用 'lang_{language_code}' 格式（例如 'lang_en'）将结果限制为一种或多种语言。请参阅 Google LR 语言。
uule	否	string		用于精确定位 Google 搜索结果的编码位置字符串 (UULE)。这是一个高级/技术参数——如果您不熟悉，可以留空并省略。
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		用于过滤图片的附加建议搜索词（chips）。值从之前的响应中获取。
tbs	否	string		用于应用 Google 结果过滤器（例如时间范围）的高级搜索过滤器参数 (tbs)。这是一个高级参数——如果您不熟悉，可以留空。
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：知识共享。也接受旧版值 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))
}

响应

正在加载最新响应示例...