Skip to content
Gridlode
LiveSocial media and video1 credit / request

TikTok Video API

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.

GEThttps://api.gridlode.com/v1/social/tiktok/video

Parameters

NameTypeDescription
urlstringVideo URL, e.g. https://www.tiktok.com/@tiktok/video/7704834703446117662 or a vm.tiktok.com short link.
Default: null
video_idstringNumeric TikTok video id. Used when url is not given.
Default: null
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    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"
    1 credit per request
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 1 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: Apify TikTok video scrapers ~$3-5 per 1k.

    Questions

    How much does the TikTok Video API cost?

    1 credit per request. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Social media and video
    All 13 in Social media and video · 7 live
    Live

    YouTube Video Details

    Public metadata of one YouTube video from its watch page, as a signed-out visitor sees it

    1 credit / requestDocs
    Live

    TikTok Profile

    A public TikTok creator or brand profile exactly as a signed-out visitor sees it

    2 credits / requestTry freeDocs
    Live

    YouTube Comments

    Public comments on one YouTube video, in YouTube's Top or Newest order, exactly as a signed-out visitor can load them

    0.05 credits / commentDocs
    Soon

    Meta Ad Library

    Search Meta's public Ad Library (Facebook, Instagram, Messenger, Audience Network) by keyword or advertiser Page id for any country

    2 credits / pageDocs