Google Images API
获取结构化的 JSON 格式 SERP 数据，可直接集成到您的工具和工作流程中。通过单次 API 调用即可获取任何关键词、位置或设备的实时准确结果——无需管理代理、验证码和基础设施。
q
搜索查询
*
API 参数
获取实时搜索引擎结果，仅为有效响应付费。
输入参数
q
搜索查询
搜索查询内容
cr
设置多个国家（cr 参数）
该参数定义一个或多个用于限制搜索范围的国家。使用 country {两个大写字母的国家代码} 来指定国家，并用 | 分隔（例如，countryFR|countryDE 仅搜索法国和德国的页面）。如需查看所有支持的国家，请访问谷歌 cr 国家页面。
gl
国家（GL 参数）
该参数定义谷歌图片搜索所使用的国家，使用两个字母的国家代码（例如，美国为 us，英国为 uk，法国为 fr）。如需查看所有支持的谷歌国家，请访问谷歌国家列表。
hl
界面语言（HL 参数）
该参数定义谷歌图片搜索使用的语言，使用两个字母的语言代码（例如，英语为 en，西班牙语为 es，法语为 fr）。如需查看所有支持的谷歌语言，请访问谷歌语言列表。
num
结果数量
该参数定义要返回的最大结果数量（例如，10（默认）返回 10 条结果，40 返回 40 条结果，100 返回 100 条结果）。 使用 num 参数可能会增加延迟，或导致无法包含特定类型的结果。除非确实需要增加每页结果数量，否则建议省略此参数。 不保证返回结果的数量与 num 中指定的数量完全一致。
tbs
高级搜索参数
（待搜索）该参数定义常规查询字段中无法设置的高级搜索参数（例如，针对专利、日期、新闻、视频、图片、应用或文本内容的高级搜索）。
nfpr
禁用个性化结果（NFPR）
该参数定义当原始查询拼写错误时，是否排除自动更正查询的结果。设置为 1 时排除此类结果，设置为 0 时包含（默认）。请注意，如果没有其他结果可用，此参数可能无法阻止谷歌返回自动更正查询的结果。
safe
成人内容筛选
该参数定义成人内容的筛选级别。可设置为 “启用” 或 “关闭”，默认情况下谷歌会模糊显示露骨内容。
uule
编码地区
该参数是用于搜索的谷歌编码地区。uule 和 location 参数不能同时使用。
chips
图片搜索筛选（备选）
该参数支持对图片搜索进行筛选，是谷歌提供的建议搜索字符串（例如：红苹果）。当 ijn = 0 时，建议搜索的 chips 会在 suggested_searches 部分下提供，每个建议搜索都会包含 chips 和 serpapi_link 值。
imgar
宽高比筛选
该参数定义图片的宽高比设置。 选项：s - 正方形 t - 竖版 w - 横版 xw - 全景
imgsz
图片尺寸筛选
该参数定义图片的尺寸。 选项：l - 大尺寸 m - 中尺寸 i - 图标 qsvga - 大于 400×300vga - 大于 640×480svga - 大于 800×600xga - 大于 1024×7682mp - 大于 200 万像素 4mp - 大于 400 万像素 6mp - 大于 600 万像素 8mp - 大于 800 万像素 10mp - 大于 1000 万像素 12mp - 大于 1200 万像素 15mp - 大于 1500 万像素 20mp - 大于 2000 万像素 40mp - 大于 4000 万像素 70mp - 大于 7000 万像素
start
结果偏移量
该参数定义结果的偏移量，用于跳过指定数量的结果，适用于分页场景（例如，0（默认）为第一页结果，10 为第二页结果，20 为第三页结果等）。 谷歌本地结果仅接受 20 的倍数作为 start 值（例如，20 为第二页结果，40 为第三页结果等）。
filter
启用结果筛选（Filter）
该参数定义 “相似结果” 和 “省略结果” 的筛选器是否开启。设置为 1（默认）时启用这些筛选器，设置为 0 时禁用。
end_date
结束日期
该参数定义限制图片搜索范围的时间段的结束日期。 格式：YYYYMMDD 示例：20241231 该参数不能与 period_unit/period_value 参数同时使用。end_date 为空时，start_date 表示搜索从该日期到今天的内容。 该参数会覆盖 tbs 参数中的 cdr 和 cd_max 组件。
licenses
使用权限筛选
该参数定义图片的使用权限范围。 选项：f - 可免费使用或分享 fc - 可免费使用或分享（含商业用途） m - 可免费使用、分享或修改 fmc - 可免费使用、分享或修改（含商业用途）cl - 知识共享许可 ol - 商业及其他许可 该参数会覆盖 tbs 参数中的 sur 组件。
location
地区
该参数定义搜索的来源地区。如果有多个地区与请求的地区匹配，我们将选择最常用的那个。如需更精确的控制，请访问 /locations.json API。location 和 uule 参数不能同时使用。建议将地区指定到城市级别，以模拟真实用户的搜索。如果省略 location 参数，搜索可能会采用代理服务器的位置。
no_cache
禁用缓存（No Cache）
该参数会强制 SerpApi 即使存在缓存版本，也重新获取谷歌结果。仅当查询和所有参数完全相同时，才会提供缓存。缓存有效期为 1 小时。缓存搜索是免费的，不计入每月搜索次数限制。设置为 false（默认）时允许使用缓存结果，设置为 true 时不允许使用缓存结果。no_cache 和 async 参数不能同时使用。
image_type
图片类型筛选
该参数定义图片的类型。 选项：face - 人像 photo - 照片 clipart - 剪贴画 lineart - 线稿 animated - 动态图 该参数会覆盖 tbs 参数中的 itp 组件。
start_date
开始日期
该参数定义限制图片搜索范围的时间段的开始日期。 格式：YYYYMMDD 示例：20241201 该参数不能与 period_unit/period_value 参数同时使用。start_date 为空时，end_date 表示搜索截止到该日期之前的内容。 该参数会覆盖 tbs 参数中的 cdr 和 cd_min 组件。
image_color
图片颜色筛选
该参数定义图片的颜色。 选项：bw - 黑白 trans - 透明 red - 红色 orange - 橙色 yellow - 黄色 green - 绿色 teal - 青绿色 blue - 蓝色 purple - 紫色 pink - 粉色 white - 白色 gray - 灰色 black - 黑色 brown - 棕色 该参数会覆盖 tbs 参数中的 ic 和 isc 组件。
period_unit
时间段单位
该参数定义搜索近期图片的时间段单位，例如：过去一分钟、一小时、一天等。 选项：s - 秒 n - 分钟 h - 小时 d - 天 w - 周 m - 月 y - 年 该参数不能与 start_date/end_date 参数同时使用。 该参数会覆盖 tbs 参数中的 qdr 组件。
period_value
时间段数值
该参数定义可选的时间段数值，可与 period_unit 搭配使用，描述如 15 秒、42 小时、178 天等时间段。 默认值：1 数值范围：1..2147483647。
google_domain
谷歌域名
该参数定义要使用的谷歌域名，默认值为 google.com。如需查看所有支持的谷歌域名，请访问谷歌域名列表。
输入
{
"engine":"google_images"
"q":"xcrawl.com"
"cr":""
"gl":""
"hl":""
"num":0
"tbs":""
"nfpr":false
"safe":1
"uule":""
"chips":""
"imgar":""
"imgsz":""
"start":0
"filter":false
"end_date":""
"licenses":""
"location":""
"no_cache":false
"image_type":""
"start_date":""
"image_color":""
"period_unit":""
"period_value":""
"google_domain":"google.com"
},
输出
{
},
灵活定价
为真实世界的网络数据提取而设计的透明定价。免费开始，随着您的成长而扩展。
我们接受以下支付方式：
...
... 扩展套餐
为需要更强大功能和专属支持的团队提供的高容量套餐。
享受更高的速率限制、更多并发浏览器和优先支持。
企业级解决方案
适用于任何规模的安全可靠的网络数据提取提供商。99.95% 正常运行时间。符合 SOC2、GDPR 和 CCPA 标准。
ISO 27001
GDPR
用户高评价
行业领导者
最易使用奖
最佳价值奖常见问题
了解关于 XCrawl 的一切信息。
您的 API 支持多少个国家/地区的精确地理位置定位？
我们的 API 支持全球 200 多个国家和地区的精确地理位置定位，包括北美、欧洲、亚太、拉丁美洲和中东的主要市场。您可以在国家、州或城市级别定位结果，支持通过 ISO 代码、坐标或自定义位置 ID 定义的数千个特定位置。这确保您的 SERP 数据准确反映本地搜索意图和区域市场动态。
如何将 API 集成到我的应用或平台中？
您可以通过直接 API 拉取、webhook 或输出到您首选的存储目标进行集成。结构化的 SERP 数据也可以无缝直接馈送到您的 AI 代理工作流程中，以实现实时数据驱动的决策。
您的定价是如何计算的？
我们使用基于成功搜索/积分的按需付费/订阅层级模式。仅计算成功的 API 响应——失败的请求、超时和错误不会产生费用。我们提供月度和年度计划（年度计划包含折扣），并采用透明的基于数量的定价。
您接受哪些支付方式？
我们支持所有主要支付方式以满足您的多样化需求：包括 Visa、Mastercard、American Express 和其他主流信用卡/借记卡、PayPal，以及为企业客户提供的专属银行转账服务。我们灵活的全球支付选项旨在简化您的交易体验。
您提供技术支持吗？
是的，我们为所有用户提供持续的技术支持。我们的支持团队随时为您提供集成、故障排除和一般问题的帮助。
有免费试用或免费计划吗？
是的，我们提供免费试用/免费计划，以便您可以在升级到付费计划之前测试我们的 API、检查数据质量并验证集成。
