抖音作品下载链接 API

用 urls 一次取多条抖音作品的视频下载链接、封面和下载要带的 request_headers;urls 里每项算一次,每千次 $0.56。

  • 链接带签名、会过期,失效时间看 expires_at
  • fresh 为 true 时不用缓存、当场重新取
  • 失败和空结果不收费
免费开始

接口健康状态

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

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "media_links",
      "params": {
        "urls": [
          "https://www.douyin.com/video/<VIDEO_ID_A>"
        ]
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "media_type": string,
          "video_url": string,
          "video_url_expires_at": string,
          "video_width": number
        },
        …
      ]
    }
  3. 3行

    media_typevideo_urlvideo_url_expires_atvideo_width
    stringstringstringnumber
  4. 4CSV

    douyin-media_links-sample.csv id,url,media_type,video_url,video_url_expires_at,video_width,video_height,video_size_bytes,has_watermark,best_stream,stream_count,cover_image_url,covers,image_urls,audio_url,request_headers,expires_at,fetched_at,platform,input

请求带 urls,返回每条作品一行,带 video_url、best_stream 和 request_headers,列成字段表,也可下载为 CSV。

能拿到什么数据

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

字段类型含义
idstring该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
urlstring该记录在原平台上的可访问链接。
media_typestring媒体类型。
video_urlstring视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
video_url_expires_atstring播放与下载地址的失效时间(ISO 8601,UTC);之后要重新取。
video_widthnumber视频画面宽度(像素)。
video_heightnumber视频画面高度(像素)。
video_size_bytes—视频文件大小(字节,media_links)。
has_watermarkboolean平台对这条作品视频文件的水印标记(true 表示带水印)。
best_stream—码率最高的那一路视频流(media_links):{url, bitrate(bps), width, height, size_bytes, expires_at(失效时间)}。
stream_count—这条视频一共有几路不同清晰度的流(media_links)。
cover_image_urlstring封面图链接:search / user_posts / posts_batch / related_posts / mix_posts / music_posts / media_links 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图,user_mixes 是合集封面,live_room 是直播间封面;带签名的会过期。
covers—各种封面图(media_links):[{url, width, height, expires_at}];第一张同 cover_image_url。
image_urls—图片链接数组,按平台展示顺序;没有图片时不出现这个字段。
audio_urlstring音频地址:transcript 是视频音轨(mp3),music_search、music_detail 是这段音乐的播放地址,media_links 是作品配乐的地址;可能会过期。
request_headers—下载这些链接时要带的请求头(media_links),例如 {"Referer": "https://www.douyin.com/"};不带可能被拒。
expires_at—这一行里最早失效的那个链接的失效时间(media_links,ISO 8601,UTC);过了要重新取(fresh=true)。
fetched_at—这些链接取到的时间(media_links,ISO 8601,UTC);没传 fresh 时可能是缓存里的。
platformstring数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
input—这一行对应的你传的那一项(posts_batch、profiles_batch、media_links 的 urls 里原样那个值),用来把结果对回去。

用途

  • 批量取下载地址

    把一批视频 ID 或视频链接放进 urls,读各行的 video_url 去下载。

  • 挑最高码率的一路

    读 best_stream,里面有码率最高的那路流的地址、码率、宽高和大小。

  • 下载时带对请求头

    把 request_headers 里的头原样带上(例如 Referer),不带可能被拒。

  • 链接过期后重取

    expires_at 过了,用 fresh 为 true 重新请求,换一批新链接。

抖音开放平台 与 EveryInfra 对比

下面拿抖音开放平台「总体授权说明」里的原文,对比 EveryInfra media_links 怎么接入。

对比项抖音开放平台EveryInfra
授权渠道"抖音开放平台现已开放WEB、Android、iOS和JS四种渠道的授权方式能力"不用接抖音的授权 SDK 或 JSSDK;直接发 HTTPS 请求,请求头放 EveryInfra API Key,urls 里放要取链接的作品。

引文出自抖音开放平台「总体授权说明」页,2026-11-22 核对;页面没有标更新日期。抖音官方文档没有讲作品下载链接,所以这里只比接入方式。 官方出处: 总体授权说明

限制和注意事项

  • urls 是数组,一次能传几项见参数说明;同一项只能出现一次。
  • 每项只收纯数字视频 ID,或含这个 ID 的视频链接;不收短链和分享口令。
  • 按个数计费,每项算一次;没取到的不收费,列在响应的 missed 里。
  • 链接带签名,会过期;expires_at 是这一行里最早失效的那个链接的时间。
  • has_watermark 为 true 表示视频文件带水印。
  • 不传 fresh 时,链接可能来自缓存,取到的时间在 fetched_at。
  • 只支持同步调用。

价格

urls 里每一项算一次,每次 $0.000556,按个数计费,不按字段多少算;没取到的不收费。失败和空结果不收费。

调用次数费用
10,000$5.56
100,000$55.56
1,000,000$555.56

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

代码示例

#
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": "media_links",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>"
    ]
  }
}'

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

把 <> 里的占位换成真实视频 ID。urls 放最多 20 个视频,每项是视频 ID 或视频链接,不收短链和分享口令;返回的下载链接带签名、会过期,下载时带上每行的 request_headers。

API 参考

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

POST

AI 提示词

#
请帮我用 EveryInfra 的「抖音作品下载链接」接口(douyin/media_links)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 douyin,action 填 media_links,参数放在 params 里。
- 必填参数:
  - urls:要取下载链接的视频,一次最多 20 个,数组,同一项只能出现一次;按个数计费,每个算一次,没取到的退回。返回行带 input,原样是你传的那一项,用来对回去。
- 可选参数:
  - fresh:true 时不用缓存、当场重新取链接(链接带签名,会过期,过期时间看 expires_at);默认 false。
  - limit:这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。
- 返回一组记录,每条记录的主要字段:id、url、media_type(媒体类型)、video_url(视频播放地址(带签名、会过期)、video_url_expires_at(播放与下载地址的失效时间(ISO…)、video_width(视频画面宽度(像素))、video_height(视频画面高度(像素))、video_size_bytes(视频文件大小(字节)、has_watermark(平台对这条作品视频文件的水印标记(…)、best_stream(码率最高的那一路视频流(media…)、stream_count(这条视频一共有几路不同清晰度的流(…)、cover_image_url(封面图链接:search / us…);一共 19 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=douyin。
- 示例请求体:
{
  "platform": "douyin",
  "action": "media_links",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>"
    ]
  }
}
- 计费:$0.56 / 千次;失败和空结果不扣费。
- 这个接口只能同步调用,请求体里不要加 "mode": "async"。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

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

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是douyin平台标识,固定值。
actionbodystring是media_links能力标识,固定值。
urlsbody.paramsarray是-要取下载链接的视频,一次最多 20 个,数组,同一项只能出现一次;按个数计费,每个算一次,没取到的退回。返回行带 input,原样是你传的那一项,用来对回去。每项是 抖音视频:纯数字视频 ID,或含这个 ID 的视频链接(https://www.douyin.com/video/<视频ID>);不收短链和分享口令。
freshbody.paramsboolean否-true 时不用缓存、当场重新取链接(链接带签名,会过期,过期时间看 expires_at);默认 false。
limitbody.paramsinteger (1–)否-这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。

响应示例

#
这组示例参数还没有真实样例:这里只按接口定义列出响应结构和字段,值用 … 占位,不是一次真实调用的结果。
json
{  "id": "req_…",  "platform": "douyin",  "action": "media_links",  "results": [    {      "id": …,      "url": …,      "media_type": …,      "video_url": …,      "video_url_expires_at": …,      "video_width": …,      "video_height": …,      "video_size_bytes": …,      "has_watermark": …,      "best_stream": …,      "stream_count": …,      "cover_image_url": …,      "covers": …,      "image_urls": …,      "audio_url": …,      "request_headers": …,      "expires_at": …,      "fetched_at": …,      "platform": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

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

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url该记录在原平台上的可访问链接。
media_type媒体类型。
video_url视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
video_url_expires_at播放与下载地址的失效时间(ISO 8601,UTC);之后要重新取。
video_width视频画面宽度(像素)。
video_height视频画面高度(像素)。
video_size_bytes视频文件大小(字节,media_links)。
has_watermark平台对这条作品视频文件的水印标记(true 表示带水印)。
best_stream码率最高的那一路视频流(media_links):{url, bitrate(bps), width, height, size_bytes, expires_at(失效时间)}。
stream_count这条视频一共有几路不同清晰度的流(media_links)。
cover_image_url封面图链接:search / user_posts / posts_batch / related_posts / mix_posts / music_posts / media_links 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图,user_mixes 是合集封面,live_room 是直播间封面;带签名的会过期。
covers各种封面图(media_links):[{url, width, height, expires_at}];第一张同 cover_image_url。
image_urls图片链接数组,按平台展示顺序;没有图片时不出现这个字段。
audio_url音频地址:transcript 是视频音轨(mp3),music_search、music_detail 是这段音乐的播放地址,media_links 是作品配乐的地址;可能会过期。
request_headers下载这些链接时要带的请求头(media_links),例如 {"Referer": "https://www.douyin.com/"};不带可能被拒。
expires_at这一行里最早失效的那个链接的失效时间(media_links,ISO 8601,UTC);过了要重新取(fresh=true)。
fetched_at这些链接取到的时间(media_links,ISO 8601,UTC);没传 fresh 时可能是缓存里的。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
input这一行对应的你传的那一项(posts_batch、profiles_batch、media_links 的 urls 里原样那个值),用来把结果对回去。

错误与计费

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

错误码

常见问题

作品下载链接接口返回什么?

每个取到的作品一行:id、url、media_type、video_url、video_size_bytes、has_watermark、best_stream、stream_count、cover_image_url、covers、audio_url、request_headers、expires_at、fetched_at,另有 input。

链接过期了怎么办?

看 expires_at;过了以后用 fresh 为 true 重新请求,会当场取新链接。

下载时被拒绝怎么办?

带上这一行的 request_headers,例如 Referer;不带可能被拒。

能传 v.douyin.com 短链吗?

不能。只收纯数字视频 ID 和含这个 ID 的视频链接。手里是短链或分享口令时,先交给 posts_batch(它收这两种),用返回行的 id 再来取。

批量取下载链接怎么算钱?

urls 里每一项算一次,每次 $0.000556,每千次 $0.56。失败和空结果不收费。

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

Google Analytics 同意才加载 隐私