/ 接口详情
抖音主页解析
通过通过输入抖音主页的分享链接进行解析获取视频链接
接口信息
GET / POST
api-v2.317ak.com/api/jxfl/dyzyjx/api.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| url | string | 是 | 传入抖音分享的主页链接 | 8- 长按复制此条消息，打开抖音搜索，查看TA的更多作品。 https://v.douyin.com/pC1nBxxPhnU/ 5@9.com :8pm |
| count | string | 否 | 需要获取的视频数量。 | 5 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "url",
"type": "string",
"required": true,
"description": "传入抖音分享的主页链接",
"example": "8- 长按复制此条消息，打开抖音搜索，查看TA的更多作品。 https://v.douyin.com/pC1nBxxPhnU/ 5@9.com :8pm"
},
{
"name": "count",
"type": "string",
"required": false,
"description": "需要获取的视频数量。",
"example": "5"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "抖音主页解析",
"description": "通过通过输入抖音主页的分享链接进行解析获取视频链接",
"version": "1.0.0"
},
"paths": {
"/api/jxfl/dyzyjx/api.php": {
"get": {
"summary": "抖音主页解析",
"description": "通过通过输入抖音主页的分享链接进行解析获取视频链接",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "url",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "8- 长按复制此条消息，打开抖音搜索，查看TA的更多作品。 https://v.douyin.com/pC1nBxxPhnU/ 5@9.com :8pm"
},
"description": "传入抖音分享的主页链接"
},
{
"name": "count",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "5"
},
"description": "需要获取的视频数量。"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "抖音主页解析",
"description": "通过通过输入抖音主页的分享链接进行解析获取视频链接",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "url",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "8- 长按复制此条消息，打开抖音搜索，查看TA的更多作品。 https://v.douyin.com/pC1nBxxPhnU/ 5@9.com :8pm"
},
"description": "传入抖音分享的主页链接"
},
{
"name": "count",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "5"
},
"description": "需要获取的视频数量。"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https://api-v2.317ak.com",
"description": "当前访问入口（https）"
}
]
}
返回示例
{
"code": 200,
"msg": "success",
"data": [
{
"index": 1,
"aweme_id": "7598178592926200443",
"desc": "两条鱼八百个心眼子#扔水瓶挑战 #办公室游戏 #增进友谊小游戏 #反转 #大葱呀",
"create_time": "2026-01-23 17:16:59",
"share_url": "https://www.douyin.com/video/7598178592926200443",
"author": "大葱呀",
"author_uid": "1519973905733379",
"author_sec_uid": "MS4wLjABAAAAgNP8APYNUl_UeusvetkOjL4EgQth4Cw_Le-1YOItDTda9HfAg0NFCbqUYg_WI13-",
"type": "video",
"cover": "https://p3-pc-sign.douyinpic.com/tos-cn-i-0813c000-ce/oczefADcyTDEkF9upaVmcAnAwI6kCNzQAAtiEj~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2084709600&x-signature=1k4aBzoEAIlSMuIm4VbzhnlZXlc%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=202601252248214E6FF2FB4F322F62593F",
"url": "https://www.douyin.com/aweme/v1/play/?video_id=v2700fgi0000d5p2cnfog65oo4qu4jcg&line=0&file_id=b97970fdac35489b92ab2c5698ce2975&sign=ca4d0636a17cf6e35b43d6c92f3317e4&is_play_url=1&source=PackSourceEnum_PUBLISH",
"duration": 252.471,
"music_title": "@大葱呀创作的原声",
"music_author": "大葱呀",
"music_url": "https://lf26-music-east.douyinstatic.com/obj/ies-music-hj/7598178547659754277.mp3",
"statistics": {
"digg_count": 20892,
"comment_count": 672,
"share_count": 19983,
"collect_count": 1210,
"play_count": 0
},
"hashtags": [
"扔水瓶挑战",
"办公室游戏",
"增进友谊小游戏",
"反转",
"大葱呀"
]
},
{
"index": 2,
"aweme_id": "7596999002332073267",
"desc": "小黄挺抗电啊 #扔水瓶挑战 #电击疗法 #办公室游戏 #增进友谊小游戏 #大葱呀",
"create_time": "2026-01-19 17:16:18",
"share_url": "https://www.douyin.com/video/7596999002332073267",
"author": "大葱呀",
"author_uid": "1519973905733379",
"author_sec_uid": "MS4wLjABAAAAgNP8APYNUl_UeusvetkOjL4EgQth4Cw_Le-1YOItDTda9HfAg0NFCbqUYg_WI13-",
"type": "video",
"cover": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/04247531c3094470a43aec61230f584d~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2084709600&x-signature=BRK8y39f94nJL78OGbsPj0%2FTpWU%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=202601252248214E6FF2FB4F322F62593F",
"url": "https://www.douyin.com/aweme/v1/play/?video_id=v0d00fg10000d5muuuvog65q7m2781s0&line=0&file_id=abd9a5f4cac54e84a08dde52914366cb&sign=7e00b1805cd16d30b52e3331856cb4e4&is_play_url=1&source=PackSourceEnum_PUBLISH",
"duration": 262.293,
"music_title": "@大葱呀创作的原声",
"music_author": "大葱呀",
"music_url": "https://sf5-hl-cdn-tos.douyinstatic.com/obj/ies-music/7596999140555459337.mp3",
"statistics": {
"digg_count": 61773,
"comment_count": 2922,
"share_count": 146219,
"collect_count": 3470,
"play_count": 0
},
"hashtags": [
"扔水瓶挑战",
"电击疗法",
"办公室游戏",
"增进友谊小游戏",
"大葱呀"
]
},
{
"index": 3,
"aweme_id": "7589948399403666703",
"desc": "祝大家新年快乐，发大财压岁钱1000w （用小黄十年单身祝福的）#新年快乐 #新年祝福 #办公室游戏 #大葱呀",
"create_time": "2025-12-31 17:16:29",
"share_url": "https://www.douyin.com/video/7589948399403666703",
"author": "大葱呀",
"author_uid": "1519973905733379",
"author_sec_uid": "MS4wLjABAAAAgNP8APYNUl_UeusvetkOjL4EgQth4Cw_Le-1YOItDTda9HfAg0NFCbqUYg_WI13-",
"type": "video",
"cover": "https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/2c97811d0d434018af2ce8c2ced26bc6~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2084709600&x-signature=ptqumLHoPHBYxpktvkVEpM7WjNo%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=202601252248214E6FF2FB4F322F62593F",
"url": "https://www.douyin.com/aweme/v1/play/?video_id=v0d00fg10000d5ae1qfog65r0u6rvbf0&line=0&file_id=fea0d7d88117483bbbda516ec0d8c638&sign=533f760d5d75f200283855bddc09d1be&is_play_url=1&source=PackSourceEnum_PUBLISH",
"duration": 215.018,
"music_title": "@大葱呀创作的原声",
"music_author": "大葱呀",
"music_url": "https://sf5-hl-cdn-tos.douyinstatic.com/obj/ies-music/7589948559383300927.mp3",
"statistics": {
"digg_count": 391101,
"comment_count": 18790,
"share_count": 498194,
"collect_count": 20670,
"play_count": 0
},
"hashtags": [
"新年快乐",
"新年祝福",
"办公室游戏",
"大葱呀"
]
},
{
"index": 4,
"aweme_id": "7599225239423241499",
"desc": "两条鱼八百个心眼子 #扔水瓶挑战 #办公室游戏 #增进友谊小游戏 #社交的手腕 #大葱呀",
"create_time": "2026-01-25 17:16:11",
"share_url": "https://www.douyin.com/video/7599225239423241499",
"author": "大葱呀",
"author_uid": "1519973905733379",
"author_sec_uid": "MS4wLjABAAAAgNP8APYNUl_UeusvetkOjL4EgQth4Cw_Le-1YOItDTda9HfAg0NFCbqUYg_WI13-",
"type": "video",
"cover": "https://p9-pc-sign.douyinpic.com/tos-cn-i-0629/owAfviU1AlJqOB4FIU6gptAtBpiTu0CBQAB1En~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2084709600&x-signature=khYV8dwaZup6Wbwk0kKihZtU78Y%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=202601252248214E6FF2FB4F322F62593F",
"url": "https://www.douyin.com/aweme/v1/play/?video_id=v0d00fg10000d5qtm0fog65tjf3vahug&line=0&file_id=f1df632c277445a5b9808998641905f2&sign=68f0fff7889399bb0a0e2861be078ce3&is_play_url=1&source=PackSourceEnum_PUBLISH",
"duration": 273.137,
"music_title": "@大葱呀创作的原声",
"music_author": "大葱呀",
"music_url": "https://sf5-hl-cdn-tos.douyinstatic.com/obj/ies-music/7599225601443695410.mp3",
"statistics": {
"digg_count": 16428,
"comment_count": 1208,
"share_count": 40071,
"collect_count": 1225,
"play_count": 0
},
"hashtags": [
"扔水瓶挑战",
"办公室游戏",
"增进友谊小游戏",
"社交的手腕",
"大葱呀"
]
},
{
"index": 5,
"aweme_id": "7598854297563974950",
"desc": "小红：你猜我一共有几个盆 #扔水瓶挑战 #很奇怪吧脉门怎么自己就打开了 #办公室游戏 #增进友谊小游戏 #大葱呀",
"create_time": "2026-01-24 17:16:16",
"share_url": "https://www.douyin.com/video/7598854297563974950",
"author": "大葱呀",
"author_uid": "1519973905733379",
"author_sec_uid": "MS4wLjABAAAAgNP8APYNUl_UeusvetkOjL4EgQth4Cw_Le-1YOItDTda9HfAg0NFCbqUYg_WI13-",
"type": "video",
"cover": "https://p9-pc-sign.douyinpic.com/tos-cn-i-0629/os0VfkAiBEARjAVSBOAkQXIpffOD5EBGlDmr6F~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2084709600&x-signature=vNOUI5pnLIzwnP%2BVUFGlnvktQTw%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=202601252248214E6FF2FB4F322F62593F",
"url": "https://www.douyin.com/aweme/v1/play/?video_id=v0d00fg10000d5q8m5fog65jc9vvt230&line=0&file_id=7280af4d21f546ba88de05d57db1d03a&sign=262e66e83eaa0522e10c147ce06b54d1&is_play_url=1&source=PackSourceEnum_PUBLISH",
"duration": 193.237,
"music_title": "@大葱呀创作的原声",
"music_author": "大葱呀",
"music_url": "https://sf5-hl-cdn-tos.douyinstatic.com/obj/ies-music/7598854527449680681.mp3",
"statistics": {
"digg_count": 4509,
"comment_count": 284,
"share_count": 3854,
"collect_count": 257,
"play_count": 0
},
"hashtags": [
"扔水瓶挑战",
"很奇怪吧脉门怎么自己就打开了",
"办公室游戏",
"增进友谊小游戏",
"大葱呀"
]
}
],
"pagination": {
"total": 6,
"has_more": true
}
}
详细文档
抖音主页解析
接口说明
用于通过抖音主页分享链接解析获取视频链接。
适用于需要获取抖音主页作品信息的调用场景。
调用地址
https://api-v2.317ak.com/api/jxfl/dyzyjx/api.php
请求方式
支持 GET、POST 请求。
鉴权说明
接口调用需要进行密钥鉴权，请通过 Query 参数方式传递密钥：
key=接口调用密钥
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥，需通过 Query 参数 key 传递 |
| url | string | 是 | 传入抖音分享的主页链接，用于解析主页视频内容 |
| count | string | 否 | 需要获取的视频数量，例如：5 |
成功响应示例
{
"code": 200,
"msg": "success",
"data": [
{
"index": 1,
"aweme_id": "7598178592926200443",
"desc": "两条鱼八百个心眼子#扔水瓶挑战",
"create_time": "2026-01-23 17:16:59",
"share_url": "https://www.douyin.com/video/7598178592926200443",
"author": "大葱呀",
"type": "video",
"cover": "https://example.com/cover.jpg",
"url": "https://example.com/video.mp4",
"duration": 252.471,
"music_title": "@大葱呀创作的原声",
"music_author": "大葱呀",
"music_url": "https://example.com/music.mp3",
"statistics": {
"digg_count": 20892,
"comment_count": 672,
"share_count": 19983,
"collect_count": 1210,
"play_count": 0
},
"hashtags": [
"扔水瓶挑战",
"办公室游戏"
]
}
],
"pagination": {
"total": 6,
"has_more": true
}
}响应字段说明
顶层字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 响应状态标识 |
| msg | string | 响应提示信息 |
| data | array | 视频信息列表 |
| pagination | object | 分页信息 |
data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| index | integer | 视频序号 |
| aweme_id | string | 视频唯一标识 |
| desc | string | 视频描述内容 |
| create_time | string | 视频发布时间 |
| share_url | string | 视频分享链接 |
| author | string | 作者名称 |
| type | string | 内容类型 |
| cover | string | 视频封面地址 |
| url | string | 视频播放地址 |
| duration | number | 视频时长 |
| music_title | string | 音乐标题 |
| music_author | string | 音乐作者 |
| music_url | string | 音乐地址 |
| statistics | object | 视频数据统计 |
| hashtags | array | 话题标签列表 |
statistics 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| digg_count | integer | 点赞数量 |
| comment_count | integer | 评论数量 |
| share_count | integer | 分享数量 |
| collect_count | integer | 收藏数量 |
| play_count | integer | 播放数量 |
pagination 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| total | integer | 数据总数量 |
| has_more | boolean | 是否存在更多数据 |
错误响应示例
接口发生业务错误时，将返回错误信息，例如：
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁（QPM 限制） |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
调用示例
终端 curl（bash）
curl -G "https://api-v2.317ak.com/api/jxfl/dyzyjx/api.php" \
--data-urlencode "key=你的接口密钥" \
--data-urlencode "url=https://v.douyin.com/pC1nBxxPhnU/" \
--data-urlencode "count=5"PHP
// PHP
## 注意事项
- 调用接口前请妥善保管接口密钥，避免将密钥直接暴露在公开页面、客户端代码或可被他人访问的位置。
- 本接口需要通过 Query 参数 `key` 传递调用密钥，请确保参数名称和值填写正确，否则可能导致请求失败。
- 请求地址请使用 HTTPS 方式访问，传输过程中建议保持安全连接，避免敏感参数被泄露。
- `url` 参数需填写有效的抖音主页分享链接，建议直接复制完整分享内容中的链接，避免因链接缺失、失效或格式错误影响解析结果。
- `count` 参数用于控制需要获取的视频数量，传入时请使用合理范围的数值，过大的数量请求可能影响响应时间。
- 请根据实际业务需求合理控制请求频率，避免短时间内大量重复调用导致服务异常或请求受限。
- 接口返回的视频数据可能随平台内容状态变化而变化，解析结果中的视频链接、封面等信息应及时使用。快速上手
#!/bin/sh
# 抖音主页解析
curl -G \
"https://api-v2.317ak.com/api/jxfl/dyzyjx/api.php" \
--data-urlencode "key=YOUR_API_KEY" \
--data-urlencode "url=https://v.douyin.com/pC1nBxxPhnU/" \
--data-urlencode "count=5"在线测试
请求地址
api-v2.317ak.com/api/jxfl/dyzyjx/api.php
Method
参数
Response
// 结果将在此处显示
