Google Image Search

Powerful API to search and fetch Google Images in real time.

原始信息汇总

数据集概述：Google Image Search

API 名称：Google Image Search

提供者：BFD

类别：Search (搜索)

简介：该 API 提供了一种简单的方式，用于从 Google 搜索和检索图片结果。通过发送搜索查询，即可获得结构化的 JSON 响应，包含图片 URL、标题、缩略图、来源页面、尺寸及其他有用的元数据。该 API 旨在实现速度、可靠性和无缝集成，适用于 AI 应用、搜索引擎、自动化、内容聚合、数据分析和自定义图片项目。

核心功能：实时搜索并获取 Google 图片结果。

订阅方案：

• BASIC: $0.00/月
• PRO: $15.00/月
• ULTRA: $25.00/月
• MEGA: $50.00/月

---

API 技术详情

端点

• 方法：GET
• 路径：/search

请求参数

参数	类型	是否必需	默认值	描述
query / q	string	是	—	图片搜索关键词。至少需要提供 query 或 q 中的一个。
num	integer	否	10	返回的图片数量。最大值为 50。
gl	string	否	""	用于影响搜索结果的国家代码（地理位置），例如 US 或 ID。留空则使用默认位置。

请求头

请求头	必需	描述
x-rapidapi-key	是	您的 RapidAPI 订阅密钥。
x-rapidapi-host	是	google-image-search7.p.rapidapi.com
Content-Type	是	application/json

示例请求

bash curl --request GET --url https://google-image-search7.p.rapidapi.com/search?q=World%20Cup&gl=US&num=10 --header Content-Type: application/json --header x-rapidapi-host: google-image-search7.p.rapidapi.com --header x-rapidapi-key: YOUR_API_KEY

---

响应结构

顶层响应字段

字段	类型	描述
status	string	请求状态。请求成功时返回 success。
message	string	人类可读的响应消息。
items	array	图片搜索结果列表。

图片对象 (Item) 字段

字段	类型	描述
imageId	string	图片的唯一标识符。
thumbnailImageUrl	string	图片缩略图的 URL。
originalImageUrl	string	原始图片的 URL。
contextLink	string	包含该图片的网页 URL。
title	string	图片或来源页面的标题。
width	integer	原始图片的宽度（像素）。
height	integer	原始图片的高度（像素）。

---

重要说明

• 至少需要提供 query 或 q 参数中的一个。
• num 参数的最大值为 50。
• gl 参数影响搜索本地化，可能会改变返回的结果。
• 结果以 JSON 格式返回，适用于 Web、移动设备、AI、自动化和数据处理应用。