EverySearch 深度检索 API

POST

接口健康状态

24h 健康值: 正常
24h 平均耗时: —

健康 / 正常
可用
少量可用
基本不可用

正常

24 小时趋势

30 天趋势

带正文摘要的深度搜索，full=true 时连全文一起取回

单价 $0.69 / 千次（每次 $0.000694），失败与空结果不扣费。

AI 提示词

复制下面这段给你常用的 AI 助手：里面写好了这个接口的参数、返回字段和示例请求，它会先问清你的需求，再帮你写采集脚本。

请帮我用 EveryInfra 的「深度检索」接口写一个调用脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/search，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 tool 填 deep，参数放在 params 里。
- 必填参数：
  - q：查询词。
- 可选参数：
  - num：返回的结果条数。
  - full：为 true 时连全文一起取回。
- 示例请求体：
{
  "tool": "deep",
  "params": {
    "q": "coffee",
    "num": 3
  }
}
- 计费：单价 $0.69 / 千次（每次 $0.000694），失败与空结果不扣费。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要处理多少个、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`tool`	body	`string`	是	`deep`	工具名，固定值。
`q`	body.params	`string`	是	-	查询词。
`num`	body.params	`integer (1–10)`	否	`5`	返回的结果条数。
`full`	body.params	`boolean`	否	`false`	为 true 时连全文一起取回。

代码示例

bash

curl -X POST 'https://api.everyinfra.com/api/v1/search' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "tool": "deep",
  "params": {
    "q": "coffee",
    "num": 3
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

响应示例

真实返回样例

2026年10月25日 02:28（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息，列表只保留前 2 条；id、billing、quota 每次调用都不同，只给结构。

json

{
  "id": "req_…",
  "tool": "deep",
  "results": [
    {
      "title": "Coffee",
      "url": "https://en.wikipedia.org/wiki/Coffee",
      "snippet": "Coffee is a beverage brewed from roasted, ground coffee beans. Dark-colored and bitter, coffee has a stimulating effect on humans due to its caffeine content; ...",
      "content": "Coffee is a dark-colored, bitter, and stimulating beverage brewed from roasted and ground coffee beans derived from the Coffea plant. It contains caffeine, though decaffeinated options and various substitutes are also available. The production process involves separating seeds fr…"
    },
    {
      "title": "Coffee - The Nutrition Source",
      "url": "https://nutritionsource.hsph.harvard.edu/food-features/coffee/",
      "snippet": "Various polyphenols in coffee have been shown to prevent cancer cell growth in animal studies. Coffee has also been associated with decreased estrogen levels, a ...",
      "content": "Coffee has a long history of debate regarding its health benefits and risks, having transitioned from being listed as a possible carcinogen by the WHO in 1991 to being exonerated by 2016. Research indicates that moderate consumption of 3 to 5 cups per day is generally considered …"
    }
  ],
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

错误与计费

401: 缺少 Key 或 Key 无效。
402: 余额不足，先充值。
422: 参数名或取值不对，按错误信息给的候选改；不扣费。
429: 超过每分钟请求上限，按 Retry-After 等待后再试。
503: 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果: 没有数据，不扣费。

错误码