POST
接口健康状态
- 24h 健康值
- 90%
- 24h 平均耗时
- 9.27 s
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
健康
24 小时趋势
30 天趋势
热榜：返回列表，默认 20 条、单次最多 60 条；主要字段 rank、keyword、hot_value、video_count、board、image_url。
请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 douyin，action 填 trending。 单价 $0.56 / 千次（每次 $0.000556），失败和空结果都不收费。 同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。
抖音热榜按榜单读取当前的热点词条：排名、热点词、热度值、相关视频数、所属榜单和封面图，抖音给出时还有热点事件时间、历史最高名次、相关图文数和直播间数。它回答「抖音上此刻大家在看什么」，适合做选题、追热点、品牌舆情预警和内容排期。
用 boards 选榜单：hotspot 热点榜、seeding 种草榜、entertainment 娱乐榜、social 社会榜、challenge 挑战榜，可以传一个或多个，不传就是热点榜，不需要关键词。hot_value 是抖音自己的热度指标，只在同一榜单里可比，热点榜的行上常常为空；rank 是读取那一刻的名次，要看走势请定时调用，按时间把每次结果存下来。
AI 提示词
#请帮我用 EveryInfra 的「抖音热榜」接口（douyin/trending）写一个数据采集脚本。
接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 douyin，action 填 trending，参数放在 params 里。
- 没有必填参数。
- 可选参数：
- boards：热榜类型，可传单个字符串或字符串数组同时查询多个榜单：hotspot 热点榜、seeding 种草榜、entertainment 娱乐榜、social 社会榜、challenge 挑战榜。（可选值：challenge / entertainment / hotspot / seeding / social）
- limit：这次调用最多返回的条数，整数，1–60；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 20）
- 返回一组记录，每条记录的主要字段：rank（名次（从 1 开始）：trendi…）、keyword（关键词：trending 是热点词）、hot_value（热度值）、video_count（视频数：profile、billb…）、board（所属榜单）、image_url、event_time（热点事件时间）、sentence_id（热点词 ID（trending））、group_id（热点事件 ID（trending））、label（热榜角标代码（trending）、word_type（热点词类型代码（trending）、article_count（热点下的相关图文数（trendin…）；一共 19 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=douyin。
- 示例请求体：
{
"platform": "douyin",
"action": "trending",
"params": {}
}
- 计费：$0.56 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "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 | 是 | douyin | 平台标识，固定值。 |
action | body | string | 是 | trending | 能力标识，固定值。 |
boards | body.params | array | 否 | - | 热榜类型，可传单个字符串或字符串数组同时查询多个榜单：hotspot 热点榜、seeding 种草榜、entertainment 娱乐榜、social 社会榜、challenge 挑战榜。不传或传空数组时默认查询 hotspot。允许值challengeentertainmenthotspotseedingsocial |
limit | body.params | integer (1–60) | 否 | 20 | 这次调用最多返回的条数，整数，1–60；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 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": "douyin",
"action": "trending",
"params": {}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。
响应示例
#2026年10月25日 02:28（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息，列表只保留前 2 条；id、billing、quota 每次调用都不同，只给结构。
json
{ "id": "req_…", "platform": "douyin", "action": "trending", "results": [ { "rank": 1, "keyword": "渡船之上 信仰如磐", "video_count": 1, "board": "hotspot", "event_time": "2026-10-25 02:34:26", "sentence_id": "2711825", "label": 0, "word_type": 14, "is_pinned": true, "platform": "douyin" }, { "rank": 2, "keyword": "中超成都蓉城0:1大连英博", "hot_value": 11367047, "video_count": 12, "board": "hotspot", "image_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-dy/782a03e57ee24eb7b51eac3c0ee20e5e~noop.jpeg?lk3s=bfd515bb&x-expires=1792886400&x-signature=TFoV42oMHa89HkqBwV3AKbDx6sI%3D&from=3218412987", "event_time": "2026-10-24T07:01:06.000Z", "sentence_id": "2711309", "group_id": "7699487992537503010", "label": 3, "word_type": 1, "article_count": 0, "is_pinned": false, "max_rank": 1, "live_room_count": 0, "topic_view_count": 59034929, "sentence_tag": 5000, "label_icon_url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/vjl_avo_upfbvk/ljhwZthlaukjlkulzlp/hotspot_detail_page/3.png", "platform": "douyin" } ], "count": 20, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
rank | 名次（从 1 开始）：trending 是热榜排名，xingtu_creator_rankings 是星图榜单里的名次，billboard_search_hot 是搜索热榜名次，search_suggest 是联想词在抖音搜索框里的顺序；billboard_rise_list、billboard_challenge_hot、billboard_topic_hot 是热点宝榜单名次（翻页接着往下数）。 |
keyword | 关键词：trending 是热点词，billboard_search_hot 是上榜的搜索词，search_suggest 是抖音给出的联想搜索词。 |
hot_value | 热度值，抖音自有指标，只在同一榜单、同一时间窗内可比：trending 是热榜热度（热点榜 hotspot 的行上常常为空）；热点宝视频榜（billboard_video_hot 等）是榜单热度分，行按它从高到低排；billboard_search_hot 是这个词在时间窗里的搜索热度；billboard_rise_list、billboard_challenge_hot 是热点热度，billboard_topic_hot 是话题在时间窗里的热度分。 |
video_count | 视频数：profile、billboard_account_search 是账号的作品数，trending、billboard_rise_list、billboard_challenge_hot 是这个热点下的相关视频数。 |
board | 所属榜单。 |
image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
event_time | 热点事件时间。 |
sentence_id | 热点词 ID（trending）。 |
group_id | 热点事件 ID（trending）；部分热点为空。 |
label | 热榜角标代码（trending，数字，如热、新、爆）；0 表示没有角标。 |
word_type | 热点词类型代码（trending，数字）。 |
article_count | 热点下的相关图文数（trending）。 |
is_pinned | 是否置顶（作品行：作者主页置顶作品；trending：榜单置顶词）。 |
max_rank | 该热点在榜单上的历史最高名次（trending）。 |
live_room_count | 热点下的相关直播间数（trending）。 |
topic_view_count | 热点的浏览量（trending）；与 hot_value 是两个指标。null 表示没给，不等于 0。 |
sentence_tag | 热点分类代码（trending，数字）；同一代码是同一类热点。 |
label_icon_url | 热榜角标图链接（trending，如「热」「新」）；文字代码见 label。 |
related_music_id | 热点关联的背景音乐 ID（trending，部分热点有）。 |
platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
常见问题
#一次能查几个榜单？
#boards 可以传单个字符串，也可以传数组同时查多个榜单；每一行的 board 标明它来自哪个榜单，合并分析前先按它分组。不传或传空数组时只查 hotspot 热点榜。
hot_value 能跨榜单比较吗？
#不能。它是抖音自有的热度指标，只在同一个榜单内部有比较意义，热点榜的行上还经常为空。跨榜单比较请用 rank，或者看 video_count、article_count 这类相关内容的数量。
怎么追踪一个热点的走势？
#定时调用，把每次结果连同调用时间存下来，再用 sentence_id 把同一个热点词在不同时刻的行串起来，就能画出名次变化。max_rank 是它在榜单上到过的最高名次；is_pinned 为真表示榜单置顶词，做排名分析时可以单独处理。
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足，先充值。
- 422
- 参数名或取值不对，按错误信息给的候选改；不扣费。
- 429
- 超过每分钟请求上限，按 Retry-After 等待后再试。
- 503
- 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
- 200 空结果
- 没有数据，不扣费。