OpenAPI 接口文档

POST/v1/material/fetch已上线

视频数据同步

根据公开作品链接拉取播放量及相关互动指标。统一接口会自动识别链接所属平台。

Base URL

https://api.ailingtu.com

Content-Type

application/json

鉴权

Bearer Token

鉴权方式

请在 Authorization 请求头中传入 API Key。密钥应只保存在服务端，请勿暴露在浏览器或客户端代码中。

Authorization: Bearer <YOUR_API_KEY>

部分场景也支持通过 x-api-key 请求头传入密钥。

请求参数

字段类型必填说明

videoUrlstring是公开作品链接，须使用 http/https。

JSON

{
  "videoUrl": "https://www.tiktok.com/@creator/video/7123456789012345678"
}

支持平台

TikToktiktok.com

Instagraminstagram.com · instagr.am

抖音douyin.com

小红书xiaohongshu.com · xhslink.com

视频号channels.weixin.qq.com · finder.video.qq.com

YouTubeyoutube.com · youtu.be

响应数据

HTTP 状态成功且 code === 0 时请求才算成功，平台原始数据返回在 data 中。

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "videoId": "7624922739500993822",
    "uniqueId": "creator",
    "playCount": 2109422,
    "diggCount": 143027,
    "commentCount": 1320,
    "shareCount": 36150,
    "collectCount": 17710,
    "coverUrl": "https://...",
    "videoDesc": "caption #tag",
    "releaseAt": 1775315687
  },
  "timestamp": 1781491163414
}

常用指标字段

播放量playCount · videoPlayCount · videoViewCount · viewCount

点赞diggCount · likeCount

评论commentCount

分享shareCount

收藏collectCount · saveCount · favoriteCount

Instagram 播放量优先读取 videoPlayCount，其次读取 videoViewCount。不同平台返回字段可能不同。

错误处理

错误响应

{
  "code": -1,
  "message": "链接不存在",
  "data": null,
  "timestamp": 1781176395
}

401 / 403 — Token 或 API Key 无效，或当前密钥没有接口权限。

404 — 作品不存在或已删除，属于永久不可用状态，请勿继续轮询。

其它错误 — 向用户展示 message，并可根据业务场景进行短暂重试。

cURL 调用示例

Shell

curl -sS -X POST "https://api.ailingtu.com/v1/material/fetch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AILINGTU_API_KEY" \
  -d '{"videoUrl":"https://www.douyin.com/video/7123456789012345678"}'

准备开始接入？

联系我们申请 API Key 与接口访问权限。

申请接入

接入灵途 AI 开放能力