加密新闻关键词搜索 API

Q: 怎么拿到最新的报道？

搜索结果按相关度排，不按时间，所以要按 published_at 自己排序；或者改用信息流，它按发布时间从新到旧，还可以只看一家媒体。两页返回的字段完全相同。

POST

接口健康状态

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

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

正常

24 小时趋势

30 天趋势

关键词搜索：返回列表，默认 20 条、单次最多 100 条；主要字段 title、summary、source、url、published_at、project_name。

加密新闻关键词搜索按 keyword 找相关报道，keyword 长 2–100 字，例如 bitcoin ETF，默认 20 条，单次最多 100 条。每行有标题、摘要、发布媒体、原文链接、发布时间和关联项目 project_name。它回答「这个话题媒体都是怎么报道的」，适合追一个事件、一个项目或一项监管动态，也能看不同媒体对同一件事的覆盖。

结果按相关度排，不按时间，想要最新的就按 published_at 自己排序。这一页没有按媒体、按项目筛选的参数，只靠 keyword 缩小范围。summary 只有一两句话，全文看 url；source 是大写的媒体名。

单价 $4.81 / 千次（每次 $0.004806），失败与空结果不扣费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

AI 提示词

请帮我用 EveryInfra 的「加密新闻关键词搜索」接口（crypto_news/search）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 crypto_news，action 填 search，参数放在 params 里。
- 必填参数：
  - keyword：新闻搜索词，2–100 字，例如 bitcoin ETF；按相关度排，不按时间。
- 可选参数：
  - limit：这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 20）
- 返回一组记录，每条记录的主要字段：title、summary（文章摘要（一两句话））、source（发布媒体名（大写）、url（原文链接）、published_at（发布时间）、project_name（文章关联的项目或主题名（如 Bit…）。
- 示例请求体：
{
  "platform": "crypto_news",
  "action": "search",
  "params": {
    "keyword": "bitcoin ETF"
  }
}
- 计费：$4.81 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`platform`	body	`string`	是	`crypto_news`	平台标识，固定值。
`action`	body	`string`	是	`search`	能力标识，固定值。
`keyword`	body.params	`string`	是	-	新闻搜索词，2–100 字，例如 bitcoin ETF；按相关度排，不按时间。
`limit`	body.params	`integer (1–100)`	否	`20`	这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。

代码示例

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "crypto_news",
  "action": "search",
  "params": {
    "keyword": "bitcoin ETF"
  }
}'

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

响应示例

字段预览

这组示例参数还没有真实样例：这里只按接口定义列出响应结构和字段，值用 … 占位，不是一次真实调用的结果。

json

{
  "id": "req_…",
  "platform": "crypto_news",
  "action": "search",
  "results": [
    {
      "title": …,
      "summary": …,
      "source": …,
      "url": …,
      "published_at": …,
      "project_name": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

返回字段

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被补造。

字段	含义
`title`	标题。平台无标题概念时（如纯文本帖）为 null。
`summary`	文章摘要（一两句话），不是全文；全文看 url。
`source`	发布媒体名（大写，如 COINDESK、AMBCRYPTO）。
`url`	原文链接。
`published_at`	发布时间，ISO 8601 UTC。
`project_name`	文章关联的项目或主题名（如 Bitcoin、Ethereum）；没关联时没有。
`platform`	数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

常见问题

`keyword` 有什么限制？

长度 2–100 字，例如 bitcoin ETF。它搜的是新闻，也没有按媒体或项目筛选的参数；想缩小范围，就把项目名和事件名一起写进词里。

怎么拿到最新的报道？

搜索结果按相关度排，不按时间，所以要按 published_at 自己排序；或者改用信息流，它按发布时间从新到旧，还可以只看一家媒体。两页返回的字段完全相同。

`project_name` 为空是出错了吗？

不是。文章没有关联项目或主题时，这个字段整个没有；有值时是项目或主题名，例如 Bitcoin、Ethereum。读取时按缺省处理就行，按 project_name 分组还能看出结果主要落在哪几个项目上。

错误与计费

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

错误码