TikTok Ads Library Scraper
DeprecatedPricing
$3.00 / 1,000 ad scrapeds
TikTok Ads Library Scraper
DeprecatedScrape TikTok's Ad Library by keyword, advertiser name, or business ID across supported regions.
Pricing
$3.00 / 1,000 ad scrapeds
Rating
0.0
(0)
Developer
Arnas
Maintained by CommunityActor stats
0
Bookmarked
39
Total users
0
Monthly active users
2 days ago
Last modified
Categories
Share
Scrape TikTok's official Ads Library by keyword, advertiser name, or advertiser business ID across supported regions. The Actor returns clean JSON with ad IDs, advertiser names, ad type, first/last shown dates, estimated audience, spend buckets, media URLs, cover images, rejection info when TikTok discloses it, and a TikTok Ads Library deeplink.
Input
At least one of search, ad_id, or adv_biz_ids is required.
| Field | Default | Description |
|---|---|---|
search | - | Advertiser name or keyword. |
ad_id | - | Specific ad ID. When used alone, returns a deeplink record. |
adv_biz_ids | - | TikTok advertiser business ID. Requires search with the advertiser name. |
region | all | ISO country code or all. TikTok does not support US; use all for global results. |
query_type | 1 | 1 = advertiser name or keyword, 0 = keyword in ad content. |
sort | last_shown_date,desc | Sort by shown dates or impressions. |
start_date | one year ago | Lower bound for last-shown date, YYYY-MM-DD. |
end_date | today | Upper bound for last-shown date, YYYY-MM-DD. |
limit | 20 | Number of ads to return, 1-100. |
offset | 0 | Number of ads to skip (use nextOffset + search_id from a previous run). |
search_id | - | Optional pagination token returned by TikTok. |
proxy_url | - | Optional HTTP(S) proxy URL. |
proxyConfiguration | no proxy | Optional Apify proxy settings. Not needed normally; the actor falls back to residential proxy automatically if direct requests are blocked. |
Output
Each dataset item has type: "ad" for search results or type: "ad-deeplink" for ad-ID-only runs.
Important fields:
adId,advertiserName,auditStatus,adTypefirstShownAt,lastShownAt,daysRunningestimatedAudience,spend,impressionsvideoUrls,coverImageUrls,imageUrlsrejectionInfo,deeplink
The run OUTPUT includes total, pushed, hasMore, searchId, and nextOffset for pagination. To fetch the next page, pass both offset: nextOffset and search_id: searchId from the previous run — the TikTok cursor is required for pages beyond the first.
