Skip to content
Gridlode
Launching soonSocial media and video2 credits / page

TikTok Ad Library API

Search TikTok's public Commercial Content Library (library.tiktok.com) by advertiser name, keyword or advertiser id, for one country or all covered countries (EU/EEA, UK, Switzerland, Turkey, Brazil) and a date range: ad id, advertiser, first and last shown dates, estimated unique-user reach range, status and the creative video, cover and image URLs, 12 ads per page. Pass ad_id to get one ad with its advertiser details and targeting summary (age, gender, locations, interests, audiences). TikTok shows server IPs a "system busy" check, which we never try to bypass, so this engine runs through residential proxies. Blocks, failures and pages with no ads are free.

GEThttps://api.gridlode.com/v1/social/tiktok/ads
Get an API keyReference docs
This engine is built and is waiting for a terms review of the target site before we switch it on. Join early access through the contact form and we'll email you on launch day.

Parameters

NameTypeDescription
qstringAdvertiser name or keyword, as typed on library.tiktok.com. Wrap it in double quotes for an exact phrase.
Default: null
advertiser_idstringTikTok advertiser business id, to list that advertiser's ads (instead of q).
Default: null
ad_idstringOne ad id: returns that ad with advertiser details and its targeting summary (instead of a search).
Default: null
countrystringWhere the ads were shown: 'all' or a 2-letter code the library covers (EU/EEA countries, GB, CH, TR, BR).
Default: "all"
start_datestringFirst day shown, YYYY-MM-DD. Default: 30 days ago.
Default: null
end_datestringLast day shown, YYYY-MM-DD. Default: today.
Default: null
ad_statusstringFilter by ad status.
Default: "all"
One of: all, active, inactive
media_typestringFilter by creative type.
Default: "all"
One of: all, video, image, text
sortstringResult order (reach = estimated unique users).
Default: "last_shown_desc"
One of: last_shown_desc, last_shown_asc, published_desc, published_asc, reach_desc, reach_asc
pageintegerResults page, 12 ads per page.
Default: 1
search_idstringsearch_id returned with page 1; pass it with page 2+ to continue the same result set.
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/ads?q=nike&country=all" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    2 credits per page
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 6 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: Apify TikTok Ads Library scrapers ~$5-10 per 1k ads.

    Questions

    Part of these solutions
    How much does the TikTok Ad Library API cost?

    2 credits per page. 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

    Related APIs in this category

    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