30 天趋势
| 能力 | 做什么 | 单价 | 24 小时运行状态 · 全部正常 |
|---|---|---|---|
关键词搜索search | 将 search 返回的标题、链接和摘要作为阅读原文的入口。 | $1.39 / 千次 | 正常 |
下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。
下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。
所有能力都是同步调用。
search使用 platform="web"、action="search" 调用“关键词搜索”能力；返回列表，默认 — 条、单次最多 10 条，主要包含 title、url、text、rank、published_at、image_url 等 7 个字段。
Google 将 snippet 定义为搜索结果中的描述或摘要，并说明摘要可根据查询自动变化，也可能来自页面描述。本接口的 text 不等于目标页全文，引用事实时仍需核对原始页面。官方来源：Google：搜索摘要与网页原文的区别来源核查：
rankpublished_atSERP 搜索结果 原始字段名
EveryInfra 统一字段名
左边是 SERP 搜索结果 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。
全站 106 个平台的当前目录中，这 1 个字段名只在 SERP 搜索结果 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。
sub_links通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields
titleurltextrankpublished_atimage_url当前目录另列出 sub_links，这些字段尚无逐项释义；请先核对 SERP 搜索结果 对应接口的用例与实际响应，不按字段名猜测类型或含义。
这里按网页搜索词检索；网页正文抓取与此搜索入口不同。
以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer $EVERYINFRA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"web","action":"search","params":{"keyword":"Python documentation"}}'
仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。
{ "title": null, "url": null, "text": null, "rank": null, "published_at": null, "image_url": null, "sub_links": null }
以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。
将 search 返回的标题、链接和摘要作为阅读原文的入口。
查看 search 的 keyword 参数rank 是结果在搜索页中的位次（从 1 开始），published_at 是搜索引擎提取的页面发布时间；两者都是参考信号。
查看 search 的 keyword 参数search 的 country 和 language 参数控制搜索的市场与语言偏向；两者独立，同时使用时效果叠加。
查看 search 的 country 参数调用 POST /api/v1/social，请求体传 platform="web"、action 和 params。以 search 为例，必填 keyword，可选 country、language。这里按网页搜索词检索；网页正文抓取与此搜索入口不同。 SERP 搜索结果 共 1 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。
$1.39 / 千次，SERP 搜索结果 全部 1 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 SERP 搜索结果 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。
SERP 搜索结果 有 1 个列表接口，包括 search。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。
当前目录为 search 列出 title、url、text、rank、published_at、image_url 等 7 个字段名。按全站当前目录统计，1 个字段名只在 SERP 搜索结果 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。
将 search 返回的标题、链接和摘要作为阅读原文的入口。 keyword 是网页搜索表达式，text 是结果摘要，不是目标页全文；同一页面的摘要可能随查询变化。rank 是本次结果位次，不是固定权威分或对全部用户一致的排名。 url 会保留用于定位内容的功能性查询参数；published_at 是搜索结果提供的日期，可能缺失或不准确。引用重要事实前仍需打开原文核对，不把摘要当成完整证据。 当前公开参数目录只列 keyword，没有地区或语言筛选项；不要因为底层实现存在相关逻辑就自行追加未公布参数。需要网页正文、新闻或其他搜索类型时，应另选明确声明相应能力的接口。
rank 是结果在搜索页中的位次（从 1 开始），published_at 是搜索引擎提取的页面发布时间；两者都是参考信号。 rank 用于追踪目标页面在搜索结果中的位置变化或做结果稳定性对比；不同关键词之间不可直接比较 rank。 published_at 由搜索引擎从页面元数据或正文推断，可能缺失、过时或错误；不要用它做时效性排序的唯一依据。 text 是搜索结果摘要，不等于网页全文。需要全文时用 EverySearch 的正文读取能力，不要用摘要做事实核查或引用。
search 的 country 和 language 参数控制搜索的市场与语言偏向；两者独立，同时使用时效果叠加。 country 填小写 ISO 国家代码（如 us、cn、de），影响搜索引擎对本地内容的加权，不等于仅返回该域名下的结果。 language 控制结果页面的语言偏好，实际返回仍可能混杂其他语言，取决于目标关键词的内容生态。 做跨市场调研时，用同一关键词分别传不同 country 比较结果差异，再从 rank 和 text 判断内容偏向。
可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小时内有效。请先选择 SERP 搜索结果 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 1 个能力。无需信用卡。
自有访问统计常开；Google Analytics 仅在你点「同意分析」后启用。 隐私政策