网页购买的次数能调这个接口吗？

不能。网页会员次数不能用于本接口。请先获取密钥，再购买次数包。

请求头带 Authorization: Bearer 加 API Key 即可。请求打 https://api.youjianxiazai.cn，path 如 /api/v1/extract。

返回什么字段？

成功 data 为 id、platform、title、cover、videos、images、quota。视频项是 url 与 resolution（如 1080P）；图片项只有 url。直链会过期。没有的字段不会出现。

首页 / 开放接口

开放接口

Q: 能开发票吗？

不提供发票。提取失败会退回次数。

用 API Key 解析公开分享链接。仅支持公开内容。

次数包

次数计入本页密钥，与网页套餐无关。

购买前常见问题

密钥和次数哪个先办？

先获取密钥，再买次数包。次数只加在本页密钥上，网页套餐次数不能用在这里。

次数有期限吗？

长期有效，用完前都能用。用完再买一档，次数加在一起。

QPS 和并发多少？

QPS（每分钟请求次数）为 40，并发最多 4 路。

支持哪些平台？

以本站支持的平台列表为准。仅公开内容。

能开发票吗？

不提供发票。提取失败会退回次数。售后点页脚「联系作者」或「交流群」。

温馨提示：仅支持公开内容。请只保存你有权使用的内容，尊重创作者版权。版权归原作者所有。本站只做公开链接提取和保存辅助，不长期存放文件。购买前可用尝鲜包先试。提取失败会退回次数。虚拟次数售出后，非故障原因不退款，请确认需求再下单。不提供发票。可查看使用条款和免责声明。

接入指引

1. 接入流程

开始对接：打开获取密钥，登录后复制 API Key
请求头带 Authorization: Bearer 加 Key，再调用本项目「聚合解析」（POST /api/v1/extract）。解析成功扣 1 次
次数包在同一页面购买。密钥与次数计入开放接口账户

2. 获取参数

参数名称	参数	备注
接口域名	https://api.youjianxiazai.cn	正式环境，只用于开放接口
API Key	登录密钥购买页获取	以 `yj-` 开头，放入 `Authorization: Bearer`
接口路径	/api/v1/extract	聚合解析

补充说明：

请求须使用 HTTPS。密钥在密钥购买页登录后查看。
鉴权只认 Bearer Key。旧文档里的 X-Timestamp / X-Nonce / X-Signature 可带可忽略。
文档中的地址即为当前可调用地址，接口路径保持 /api/v1/extract 不变。

3. 开发规范

报文规范
1. 请求方式：POST
2. 请求头信息：Content-Type → application/json;charset=utf-8
3. 编码格式：UTF-8
4. 鉴权头：Authorization: Bearer 加 API Key

4. 开发 Demo

完整可运行代码都写在本项目「聚合解析」页。点「查看」后，在该页「请求示例」下按语言复制，把 yj-... 换成密钥购买页里的 API Key 即可。

平台和语言	说明	操作
cURL	完整可运行示例	查看
JavaScript	完整可运行示例	查看
Python	完整可运行示例	查看
Java	完整可运行示例	查看
Go	完整可运行示例	查看

聚合解析

名称	内容
接口地址	`https://api.youjianxiazai.cn/api/v1/extract`复制
请求方式	`POST`
Content-Type	`application/json;charset=utf-8`

请求头

参数名称	类型	必填	说明
Authorization	string	是	`Bearer` + API Key，以 `yj-` 开头。
Content-Type	string	是	`application/json`

请求体

参数名称	类型	必填	说明
url	string	是	公开作品地址，仅支持公开内容。可以是纯链接，也可以是 App「复制链接」得到的整段分享文案（含口令、短链、百分号编码查询串）。服务端会取出其中第一条 `http(s)` 地址。查询参数若已百分号编码，请保持原文，不要再解码。

示例：

{
  "url": "3.35 复制打开抖音，看看【广东华南虎的作品】兄弟们！炸了！炸了！周队可能要回来了！就在刚刚！据... https://v.douyin.com/2_XIZEgL-kg/ :2pm D@h.bN Zzg:/ 09/26"
}

url 也可传入以下形式。上面示例已是抖音 App「复制链接」整段。下面两种同样原样放入 url。

text

https://haokan.baidu.com/v?vid=7393186391122372652&pd=pcshare&hkRelaunch=p1%3Dpc%26p2%3Dvideoland%26p3%3Dshare_input

text

https://v.douyin.com/07pKdJ0vcGk/点击链接直接打开

请求示例

选语言后整段复制。把 yj-... 换成登录后看到的 API Key。请求体已是上方那条抖音分享文案。

BODY='{"url":"3.35 复制打开抖音，看看【广东华南虎的作品】兄弟们！炸了！炸了！周队可能要回来了！就在刚刚！据... https://v.douyin.com/2_XIZEgL-kg/ :2pm D@h.bN Zzg:/ 09/26"}'
curl -sS https://api.youjianxiazai.cn/api/v1/extract \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary "$BODY"

返回响应

下列为对该抖音分享文案的一次真实解析。videos.url 与 images.url 都是平台直链，会过期，请以当次响应为准。resolution 是清晰度档（如 1080P），不是像素宽高。没有的字段不会出现。quota 为次数示例。

名称	类型	说明
code	integer	与 HTTP 状态码一致
message	string	成功或失败说明
data	object	解析结果
data.id	string	记录 ID
data.platform	string	平台标识
data.title	string	作品标题
data.cover	string	封面，没有则省略
data.videos	array	视频列表
data.videos.url	string	视频直链，有时效
data.videos.resolution	string	清晰度档，如 1080P，没有则省略
data.images	array	图片列表
data.images.url	string	图片直链，有时效
data.quota	object	次数
data.quota.remaining	integer	剩余次数
data.quota.daily_remaining	integer	当日剩余

示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "id": "1234567890123456789",
    "platform": "douyin",
    "title": "兄弟们！炸了！炸了！周队可能要回来了！就在刚刚！据探长爆料！#广东宏远 已经和#周鹏 展开接触，这位功勋老将有望重返老东家。#CBA",
    "cover": "https://p3-sign.douyinpic.com/tos-cn-p-0015c000-ce/osEJfGUNA47sEPbBFeAV3IIDhgxQwiaDTzfnbn~tplv-dy-360p.jpeg?lk3s=138a59ce&x-expires=1793016000&x-signature=ApY6rOatIOgvqi83gP9NwITln1U%3D&from=327834062&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=origin_cover&biz_tag=aweme_video&l=20261012204342063DF8AF588442F7E5CC",
    "videos": [
      {
        "url": "https://v5-dy-ov-experiment.zjcdn.com/60f18bfcd8db46e3978af439741faa05/6acce431/video/tos/cn/tos-cn-ve-15c000-ce/osEFEQpfeTsIfmB7P5wUbQFGTFYDNtgJAanJhD/?a=1128&ch=26&cr=13&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=1187&bt=1187&cs=0&ds=6&ft=AB7FW8Ia9Dfx78usNKxImSVYVcWERqv2bL5oaAoiZmkaA3&mime_type=video_mp4&qs=0&rc=Mzw5aWdpaDpoZTk8NzU0Z0BpamZ3c205cjZ4PDMzbGkzNUAwY19fYzY1X18xMDIyL2A2YSM2aWtqMmRzMGRhLS1kLTVzcw%3D%3D&btag=80210e40098008&cdn_type=7&cquery=103Q_103R_103S_100b_104i&dy_q=1791809022&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20261012204342063DF8AF588442F7E5CC&n80=1&n80_dm=bjk4LXYtbmNkbmFiMy5kb3V5aW52b2QuY29t&n80_tk=278efed8ee78abf3ce805ddfc22c29b1&pdp=baidup1&pwid=1&req_cdn_type=r",
        "resolution": "1080P"
      }
    ],
    "images": [
      {
        "url": "https://p3-sign.douyinpic.com/tos-cn-p-0015c000-ce/osEJfGUNA47sEPbBFeAV3IIDhgxQwiaDTzfnbn~tplv-dy-360p.jpeg?lk3s=138a59ce&x-expires=1793016000&x-signature=ApY6rOatIOgvqi83gP9NwITln1U%3D&from=327834062&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=origin_cover&biz_tag=aweme_video&l=20261012204342063DF8AF588442F7E5CC"
      }
    ],
    "quota": {
      "remaining": 349,
      "daily_remaining": 349
    }
  }
}

状态码

失败时 HTTP 状态码与 code 一致。次数用尽时返回「今日次数已用完」。

HTTP	标识	说明
401	unauthorized	密钥无效
400	bad_request	须使用 HTTPS，或链接无效
400	unsupported	不支持该平台
403	forbidden	来源地址不在白名单
422	validation_error	请求体格式不正确
429	rate_limited	次数用尽，或请求过于频繁
503	service_unavailable	服务繁忙，请稍后再试