抖音链接识别 API

把一段文字(比如整段分享口令)交给 text,认出里面抖音视频、用户、音乐、合集和直播间的链接与 ID,认出一个返回一行,每千次 $0.79。

  • resource_type 说明是哪一类,resource_id 可直接传给对应能力
  • needs_expansion 为 true 表示是短链,还没展开
  • 失败和空结果不收费
免费开始

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "resolve_links",
      "params": {
        "text": "https://www.douyin.com/video/7539330955225484584"
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "matched_text": …,
          "match_type": …,
          "resource_type": …,
          "resource_id": …
        },
        …
      ]
    }
  3. 3行

    matched_textmatch_typeresource_typeresource_id
    …………
  4. 4CSV

    douyin-resolve_links-sample.csv matched_text,match_type,resource_type,resource_id,handle,url,needs_expansion,id_created_at,platform

请求带 text,返回认出的每一个链接或 ID,results 里每行是一个,列成字段表,也可下载为 CSV。

能拿到什么数据

这个能力还没有公开的真实样本。下表列出每行会返回的字段、类型和含义,不放值。

字段类型含义
matched_text—文字里认出来的那一段原文(resolve_links)。
match_type—认出来的是什么形式(resolve_links):link 链接、id 纯 ID 等。
resource_type—认出来的东西是哪一类(resolve_links):video 视频、user 用户、music 音乐、mix 合集、live 直播间等。
resource_id—认出来的那个东西的 ID(resolve_links):视频 ID、secUid、音乐 ID 等,可直接传给对应能力。
handle—认出来的是用户时的抖音号或名字(resolve_links);其余情况没有。
urlstring该记录在原平台上的可访问链接。
needs_expansion—是否是短链、还要展开才知道指向什么(resolve_links);为 true 时 resource_id 可能为空。
id_created_at—从 ID 本身推出来的创建时间(resolve_links,ISO 8601,UTC):抖音的视频 ID 里带着发布时间。
platformstring数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

用途

  • 从分享口令里取视频 ID

    把整段分享口令传给 text,读 resource_type 为 video 的行,resource_id 就是视频 ID。

  • 先认出作者再查资料

    文字里带用户主页链接时,resource_type 为 user 的行给出 secUid,可以交给 profiles_batch 或 profile。

  • 按类型分流一堆链接

    按 resource_type(视频、用户、音乐、合集、直播间等)把识别出的内容分给对应的能力。

  • 从视频 ID 推发布时间

    读 id_created_at,它是从视频 ID 本身推出的创建时间。

限制和注意事项

  • text 必填,是一段文字,例如整段分享口令。
  • 认出一个就是一行;match_type 说明是以链接(link)还是纯 ID(id)等形式认出来的。
  • needs_expansion 为 true 说明是短链、还要展开才知道指向什么,这时 resource_id 可能为空。
  • handle 只在认出的是用户时才有,是抖音号或名字。
  • id_created_at 是从 ID 本身推出的创建时间,抖音的视频 ID 里带着发布时间。

价格

每次调用 $0.000792,按次计费,不按认出的行数算;一次调用处理一段文字。失败和空结果不收费。

调用次数费用
10,000$7.92
100,000$79.17
1,000,000$791.67

合计按每次调用的标价算。

代码示例

#
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": "resolve_links",
  "params": {
    "text": "https://www.douyin.com/video/7539330955225484584"
  }
}'

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

API 参考

下面是 resolve_links 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「抖音链接识别」接口(douyin/resolve_links)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 douyin,action 填 resolve_links,参数放在 params 里。
- 必填参数:
  - text:一段文字(例如整段分享口令),从里面认出抖音的视频、用户、音乐、合集、直播间链接和 ID。
- 可选参数:
  - limit:这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。
- 返回一组记录,每条记录的主要字段:matched_text(文字里认出来的那一段原文(reso…)、match_type(认出来的是什么形式(resolve…)、resource_type(认出来的东西是哪一类(resolv…)、resource_id(认出来的那个东西的 ID(reso…)、handle(认出来的是用户时的抖音号或名字(r…)、url、needs_expansion(是否是短链、还要展开才知道指向什么…)、id_created_at(从 ID 本身推出来的创建时间(r…)。
- 示例请求体:
{
  "platform": "douyin",
  "action": "resolve_links",
  "params": {
    "text": "https://www.douyin.com/video/7539330955225484584"
  }
}
- 计费:$0.79 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

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

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是douyin平台标识,固定值。
actionbodystring是resolve_links能力标识,固定值。
textbody.paramsstring是-一段文字(例如整段分享口令),从里面认出抖音的视频、用户、音乐、合集、直播间链接和 ID。
limitbody.paramsinteger (1–)否-这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。

响应示例

#
这组示例参数还没有真实样例:这里只按接口定义列出响应结构和字段,值用 … 占位,不是一次真实调用的结果。
json
{  "id": "req_…",  "platform": "douyin",  "action": "resolve_links",  "results": [    {      "matched_text": …,      "match_type": …,      "resource_type": …,      "resource_id": …,      "handle": …,      "url": …,      "needs_expansion": …,      "id_created_at": …,      "platform": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

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

字段含义
matched_text文字里认出来的那一段原文(resolve_links)。
match_type认出来的是什么形式(resolve_links):link 链接、id 纯 ID 等。
resource_type认出来的东西是哪一类(resolve_links):video 视频、user 用户、music 音乐、mix 合集、live 直播间等。
resource_id认出来的那个东西的 ID(resolve_links):视频 ID、secUid、音乐 ID 等,可直接传给对应能力。
handle认出来的是用户时的抖音号或名字(resolve_links);其余情况没有。
url该记录在原平台上的可访问链接。
needs_expansion是否是短链、还要展开才知道指向什么(resolve_links);为 true 时 resource_id 可能为空。
id_created_at从 ID 本身推出来的创建时间(resolve_links,ISO 8601,UTC):抖音的视频 ID 里带着发布时间。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

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

错误码

常见问题

链接识别接口返回什么?

文字里认出的每个链接或 ID 一行:matched_text、match_type、resource_type、resource_id、handle、url、needs_expansion、id_created_at。

needs_expansion 为 true 是什么意思?

认出的是短链,还要展开才知道它指向什么;这时 resource_id 可能为空。

一段文字里有好几个链接怎么办?

认出一个返回一行,用 resource_type 和 resource_id 区分它们。

认一段文字要多少钱?

每次 $0.000792,每千次 $0.79,按调用次数算,不按认出的行数算。失败和空结果不收费。

同一把 Key 还能调用抖音的其他能力。

Google Analytics 同意才加载 隐私