谷歌搜索 API
获取结构化的 JSON 格式 SERP 数据，可直接集成到您的工具和工作流程中。通过单次 API 调用即可获取任何关键词、位置或设备的实时准确结果——无需管理代理、验证码和基础设施。
q
搜索查询
*
API 参数
获取实时搜索引擎结果，仅为有效响应付费。
输入参数
q
搜索词
搜索词
cr
设置多个国家（cr）
该参数用于将搜索限制在一个或多个国家。使用 country{两位大写国家代码} 指定国家，并用 | 分隔（例如：countryFR|countryDE 仅搜索法国和德国页面）。完整支持列表请查看 Google cr countries 页面。
gl
国家（GL）
该参数定义 Google 搜索使用的国家，使用两位国家代码（例如：us 表示美国、uk 表示英国、fr 表示法国）。完整支持列表请查看 Google countries 页面。
hl
界面语言（HL）
该参数定义 Google 搜索使用的语言，使用两位语言代码（例如：en 表示英语、es 表示西班牙语、fr 表示法语）。完整支持列表请查看 Google languages 页面。
lr
语言限制（lr）
该参数用于将搜索限制为一种或多种语言。使用 lang_{两位语言代码} 指定语言，并用 | 分隔（例如：lang_fr|lang_de 仅搜索法语和德语页面）。完整支持列表请查看 Google lr languages 页面。
si
Google 缓存搜索参数 ID
该参数定义要抓取的 Google 搜索缓存参数。使用 si 参数会返回原始加密搜索参数对应的结果。对某些搜索，si 可能覆盖除 start 和 num 之外的其他参数。si 还可用于抓取 Google 知识图谱标签页。
ibp
Google 元素渲染
该参数用于控制某些元素的布局渲染与展开（例如：gwp;0,7 可展开带 ludocid 的搜索以展示扩展知识图谱）。
tbs
高级搜索参数（tbs）
（待搜索）该参数用于定义常规查询字段中无法设置的高级搜索参数（例如：按专利、日期、新闻、视频、图片、应用或文本内容进行高级搜索）。
uds
Google 筛选搜索
该参数用于启用搜索筛选。它是 Google 提供的筛选字符串。uds 值可在 filters 部分获取，并会为每个筛选项提供 uds、q 和 serpapi_link。
lsig
附加 Google 地点 ID
该参数在某些情况下用于强制显示知识图谱地图视图。你可以通过 Local Pack API 或 Google Local API 获取 lsig ID；lsig ID 也可通过 Google My Business 中的重定向获得。
nfpr
禁用个性化结果（NFPR）
当原始查询拼写错误时，该参数用于控制是否排除自动更正后的结果。设为 1 表示排除，设为 0（默认）表示包含。注意：若没有其他可用结果，Google 仍可能返回自动更正后的结果。
uule
编码位置
该参数是你希望用于搜索的 Google 编码位置。uule 与 location 不能同时使用。
kgmid
Google 知识图谱 ID
该参数定义要抓取的 Google 知识图谱条目的 ID（KGMID），也称 Google Knowledge Graph ID。使用 kgmid 参数会返回原始加密搜索参数对应的结果。对某些搜索，kgmid 可能覆盖除 start 和 num 之外的其他参数。
start
结果偏移
该参数定义结果偏移量，用于跳过指定数量的结果并进行分页（例如：0（默认）为第 1 页，10 为第 2 页，20 为第 3 页）。Google 本地结果仅接受 20 的倍数作为 start 值（如 20 表示第 2 页，40 表示第 3 页）。
filter
启用结果过滤（Filter）
该参数定义“相似结果”和“省略结果”过滤器是否开启。可设为 1（默认）启用过滤，或设为 0 禁用过滤。
ludocid
Google 客户标识（CID）
该参数定义地点的 Google CID（客户标识）。你可以在 Google Search API 与 Google Local API 的本地结果中通过 place_id 获取，也可在 Google Maps API 的本地结果中通过 data_cid 获取；也可以使用 Google 的 CID 转换器获取。
location
地理位置
该参数定义搜索发起的位置。若与请求匹配的位置有多个，我们会选择最热门的一个。如需更精确控制，请使用 /locations.json API。location 与 uule 不能同时使用。建议将 location 设置到城市级别，以更接近真实用户搜索。若省略 location，搜索可能采用代理位置。即使仅设置 location，Google 仍可能参考代理所在国家并影响部分结果。若要更稳定的国家级过滤，请配合 gl 参数使用。
no_cache
禁用缓存（No Cache）
该参数会强制 SerpApi 拉取 Google 实时结果，即使已有缓存版本。仅当查询及全部参数完全一致时才会命中缓存；缓存 1 小时后过期。缓存搜索免费，且不计入每月搜索次数。可设为 false（默认）允许使用缓存，或设为 true 禁用缓存。no_cache 与 async 不应同时使用。
google_domain
Google 域名
该参数定义要使用的 Google 域名，默认是 google.com。完整支持列表请查看 Google domains 页面。
输入
{
"engine":"google_search"
"q":"xcrawl.com"
"cr":""
"gl":""
"hl":""
"lr":""
"si":""
"ibp":""
"tbs":""
"uds":""
"lsig":""
"nfpr":false
"uule":""
"kgmid":""
"start":0
"filter":false
"ludocid":""
"location":""
"no_cache":false
"google_domain":""
},
输出
{
},
灵活定价
为真实世界的网络数据提取而设计的透明定价。免费开始，随着您的成长而扩展。
我们接受以下支付方式：
...
... 扩展套餐
为需要更强大功能和专属支持的团队提供的高容量套餐。
享受更高的速率限制、更多并发浏览器和优先支持。
企业级解决方案
适用于任何规模的安全可靠的网络数据提取提供商。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、检查数据质量并验证集成。
