POST
/v1/material/fetchAvailableSynchronize video data
Fetch views and engagement metrics from a public video URL. A single endpoint automatically identifies the supported platform.
Base URL
https://api.ailingtu.comContent-Type
application/jsonAuthentication
Bearer TokenAuthentication
Pass your API key in the Authorization header. Keep the key on your server and never expose it in client-side code.
Authorization: Bearer <YOUR_API_KEY>
The x-api-key header is also supported in selected scenarios.
Request
FieldTypeRequiredDescription
videoUrlstringYesPublic http/https video URL.JSON
{
"videoUrl": "https://www.tiktok.com/@creator/video/7123456789012345678"
}Supported platforms
TikTok
tiktok.comInstagram
instagram.com · instagr.amDouyin
douyin.comXiaohongshu
xiaohongshu.com · xhslink.comWeChat Channels
channels.weixin.qq.com · finder.video.qq.comYouTube
youtube.com · youtu.beResponse
A request is successful only when the HTTP status is successful and code equals 0. Platform data is returned in data.
Success response
{
"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
}Common metric fields
Plays
playCount · videoPlayCount · videoViewCount · viewCountLikes
diggCount · likeCountComments
commentCountShares
shareCountSaves
collectCount · saveCount · favoriteCountFor Instagram, prefer videoPlayCount, then videoViewCount. Field names may vary by platform.
Error handling
Error response
{
"code": -1,
"message": "链接不存在",
"data": null,
"timestamp": 1781176395
}401 / 403 — The token or API key is invalid or lacks permission.
404 — The work does not exist or has been deleted. Do not continue polling.
Other errors — Display message and retry briefly when appropriate.
cURL example
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"}'Ready to integrate?
Contact us to request an API key and access permissions.