Skip to content
Gridlode
Docs · Reference

TikTok Ad Library

GET /v1/social/tiktok/ads2 credits / pagecache 360 min

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.

Query parameters

q
string
Advertiser name or keyword, as typed on library.tiktok.com. Wrap it in double quotes for an exact phrase.
Default: null
advertiser_id
string
TikTok advertiser business id, to list that advertiser's ads (instead of q).
Default: null
ad_id
string
One ad id: returns that ad with advertiser details and its targeting summary (instead of a search).
Default: null
country
string
Where the ads were shown: 'all' or a 2-letter code the library covers (EU/EEA countries, GB, CH, TR, BR).
Default: "all"
start_date
string
First day shown, YYYY-MM-DD. Default: 30 days ago.
Default: null
end_date
string
Last day shown, YYYY-MM-DD. Default: today.
Default: null
ad_status
string
Filter by ad status.
Default: "all"
Allowed: all, active, inactive
media_type
string
Filter by creative type.
Default: "all"
Allowed: all, video, image, text
sort
string
Result order (reach = estimated unique users).
Default: "last_shown_desc"
Allowed: last_shown_desc, last_shown_asc, published_desc, published_asc, reach_desc, reach_asc
page
integer
Results page, 12 ads per page.
Default: 1
search_id
string
search_id returned with page 1; pass it with page 2+ to continue the same result set.
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/ads?q=nike&country=all" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the TikTok Ad Library API page.