TikTok Ad Library API reference
Get ads from TikTok's Commercial Content Library as JSON: search by keyword or advertiser, open any ad for its targeting and reach, and see how many ads ran by country and day.
The TikTok Ad Library API has 6 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin TikTok Ad Library in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are advertiser_name and query. Prices run from 0.5 credits to 10–25 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
tiktok-adlibrary.ad.search |
Search TikTok ads by keyword, brand or slogan, by country and date range: advertiser, ad text, audience size, subject and first and last day shown. | 10–25 credits |
tiktok-adlibrary.advertiser-ads.list |
List the ads of one registered advertiser, by country and date range. | 10–25 credits |
tiktok-adlibrary.ad.detail.get |
Get one ad in full: its creative, call to action and link, the advertiser and who paid for it, targeting by age, gender and country, and reach. | 10 credits |
tiktok-adlibrary.advertiser.search |
Find an advertiser's exact registered name and business ID from part of its name. | 0.5 credits |
tiktok-adlibrary.ads.report.get |
Get TikTok's report of how many ads were published: share by country and unique ads per day, for everyone or one advertiser. | 0.5 credits |
tiktok-adlibrary.regions.list |
List the countries the library covers, with their codes. | 0.5 credits |
What to know
- Find the advertiser first Advertiser lists and reports use the advertiser's exact registered name, which the advertiser search gives you.
- Audience in bands Audience size comes as TikTok's bands, such as 100K-200K, not as exact counts.
- Recent ads by default Without dates, a search covers the last 30 days. A report covers up to 31 days at a time.
- Targeting and reach where published An ad's targeting and reach are what TikTok publishes for it; a field TikTok leaves out stays empty.
Something missing or unclear? Ask the team that builds the TikTok Ad Library endpoints.