Skip to content
Gridlode
Docs · Reference

TikTok Video

GET /v1/social/tiktok/video1 credit / requestcache 60 min

One public TikTok video by URL (including vm.tiktok.com short links) or video id: caption, author, publish date, exact plays, likes, comments, shares and saves, duration, cover, music, hashtags, language and the subtitle / auto-caption (WebVTT) links TikTok exposes to signed-out visitors. Private, removed and unknown videos are free. E-mail addresses and phone numbers inside captions are masked.

Query parameters

url
string
Video URL, e.g. https://www.tiktok.com/@tiktok/video/7704834703446117662 or a vm.tiktok.com short link.
Default: null
video_id
string
Numeric TikTok video id. Used when url is not given.
Default: null
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/social/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7704834703446117662" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the TikTok Video API page.