Ad libraries · REST API · MCP server
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.
tiktok-adlibrary.ad.search
50 rows
completed
| # | Advertiser | Ad text | Audience | First shown | Last shown | Ad ID | Audit status | Impression | Show mode | Sor audit status |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 100K-200K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011035967585 | 1 | 0 | 2 | 1 |
| 2 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879008267714690 | 1 | 0 | 2 | 1 |
| 3 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011032364849 | 1 | 0 | 2 | 1 |
| 4 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 100K-200K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011042908338 | 1 | 0 | 2 | 1 |
| 5 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011035967569 | 1 | 0 | 2 | 1 |
| 6 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011040882386 | 1 | 0 | 2 | 1 |
| 7 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011032364833 | 1 | 0 | 2 | 1 |
| 8 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011040882402 | 1 | 0 | 2 | 1 |
| 9 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879011042908322 | 1 | 0 | 2 | 1 |
| 10 | NIKE Retail B.V. | Trainiere ohne Kompromisse - im Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879008267714674 | 1 | 0 | 2 | 1 |
tiktok-adlibrary.advertiser-ads.list
50 rows
completed
| # | Advertiser | Ad text | Audience | First shown | Last shown | Subject | Ad ID | Audit status | Impression | Show mode |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | NIKE Retail B.V. | Postaw na produkty gotowe na wszystko. Zawsze. Wszędzie. | 200K-300K | 1,791,158,400,000 | 1,791,936,000,000 | Home Improvement | 1878195355527474 | 1 | 0 | 2 |
| 2 | NIKE Retail B.V. | Get the gear that's up for it all. Any time. Anywhere. | 10K-100K | 1,791,676,800,000 | 1,791,936,000,000 | Sports & Outdoor | 1878794782729521 | 1 | 0 | 1 |
| 3 | NIKE Retail B.V. | Hol dir die Ausrüstung, die alles mitmacht. Jederzeit. Überall. | 10K-100K | 1,791,504,000,000 | 1,791,936,000,000 | Apparel & Accessories | 1878556145808738 | 1 | 0 | 2 |
| 4 | NIKE Retail B.V. | Y2K vibes are back with Nike P-6000. Get styled for the circuit. | 800K-900K | 1,789,084,800,000 | 1,791,936,000,000 | Apparel & Accessories | 1875934570883330 | 1 | 0 | 1 |
| 5 | NIKE Retail B.V. | Postaw na produkty gotowe na wszystko. Zawsze. Wszędzie. | 0-1K | 1,791,936,000,000 | 1,791,936,000,000 | 1879044514345089 | 1 | 0 | 1 | |
| 6 | NIKE Retail B.V. | Sono pronti a tutto, sempre e ovunque: ecco gli articoli che ce… | 10K-100K | 1,791,504,000,000 | 1,791,936,000,000 | Apparel & Accessories | 1878605591158801 | 1 | 0 | 2 |
| 7 | NIKE Retail B.V. | Work without compromise in the Nike Hybrid RN. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879016883299762 | 1 | 0 | 2 | |
| 8 | NIKE Retail B.V. | Hol dir die Ausrüstung, die alles mitmacht. Jederzeit. Überall. | 0-1K | 1,791,936,000,000 | 1,791,936,000,000 | 1879056824469681 | 1 | 0 | 1 | |
| 9 | NIKE Retail B.V. | Place-toi sur la ligne de départ avec cette icône des années 20… | 1M-10M | 1,789,084,800,000 | 1,791,936,000,000 | Apparel & Accessories | 1875934639472337 | 1 | 0 | 1 |
| 10 | NIKE Retail B.V. | Get the gear that's up for it all. Any time. Anywhere. | 10K-100K | 1,791,936,000,000 | 1,791,936,000,000 | 1879043548210546 | 1 | 0 | 2 |
tiktok-adlibrary.ad.detail.get
completed
tiktok-adlibrary.advertiser.search
5 rows
completed
| # | Advertiser | Business ID |
|---|---|---|
| 1 | NIKE COM SRL | 7587573238117498896 |
| 2 | NIKE Retail B.V. | 6876453864464188162 |
| 3 | NIKELAB LTD | 7679265525406400530 |
| 4 | Nike Factory | 7556565840037199889 |
| 5 | Nike Factory Store | 7562123170673836048 |
What each one takes and what it returns. Open one for a real response, every input and every field.
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.
Sendquery
Returnsnametitleestimated_audiencefirst_shown_datelast_shown_datesubject
List the ads of one registered advertiser, by country and date range.
Sendadvertiser_name
Returnsnametitleestimated_audiencefirst_shown_datelast_shown_datesubject
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.
Sendad_id
Returnsadadvertiserdisplay_modetargeting
Find an advertiser's exact registered name and business ID from part of its name.
Sendquery
Returnsnamebusiness_id
Get TikTok's report of how many ads were published: share by country and unique ads per day, for everyone or one advertiser.
Sendadvertiser_nameorbusiness_idorcountry
Returnsad_activityad_published
List the countries the library covers, with their codes.
Returnsnamecode
See what a rival runs on TikTok, in which countries and for how long.
Advertiser adsAdvertisers searchAds searchOpen an ad to see the ages, genders and countries it was aimed at and how many people it reached.
Ad detailCollect ads by keyword to see which hooks, offers and calls to action a market uses.
Ads searchAd detailFollow how many ads a market or one advertiser publishes, day by day and country by country.
Ads reportSupported regionsOne request shape for every TikTok Ad Library endpoint: the endpoint ID and its input. No SDK needed.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "tiktok-adlibrary.ad.search", "input": { "query": "nike" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tiktok-adlibrary.ad.search", "input": { "query": "nike" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "tiktok-adlibrary.ad.search", "input": { "query": "nike" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
{ "total_items": 50, "items": [ { "name": "NIKE Retail B.V.", "title": "Trainiere ohne Kompromisse - im Nike Hybrid RN.", "audit_status": "1", "estimated_audience": "100K-200K", "first_shown_date": 1791936000000, "id": "1879011035967585", "impression": 0, "last_shown_date": 1791936000000, "rejection_info": null, "show_mode": 2, "sor_audit_status": "1", "spent": "", "type": "2" }, { "name": "NIKE Retail B.V.", "title": "Trainiere ohne Kompromisse - im Nike Hybrid RN.", "audit_status": "1", "estimated_audience": "10K-100K", "first_shown_date": 1791936000000, "id": "1879008267714690", "impression": 0, "last_shown_date": 1791936000000, "rejection_info": null, "show_mode": 2, "sor_audit_status": "1", "spent": "", "type": "2" } ]}
https://data.upscrape.com/mcp
Using Upscrape, search the TikTok Ad Library for nike and give me a table of advertiser, ad text, audience size and the days each ad was first and last shown.
With Upscrape, list the TikTok ads of NIKE Retail B.V. and group them by subject.
Use Upscrape to open TikTok ad 1874222777792674 and tell me who it targets by age and gender, the country, the objective and who paid for it.
The short answers. The docs have the long ones.
The countries TikTok publishes ads for: the EU and EEA, Switzerland, the UK and Turkey. The regions endpoint returns the current list.
No. Upscrape reads TikTok's public Commercial Content Library; you only need your Upscrape API key.
Ads search, advertiser ads, ad detail, advertisers search, ads report and supported regions. Each is its own endpoint with a published input schema, and the response is JSON.
Every TikTok Ad Library endpoint costs 10 credits per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.
Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the TikTok Ad Library endpoint, checks its price and runs it with the same credits as the REST API.
Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.
We fix the endpoint. Your request and the response fields stay the same.
Up to 100 free credits to start, no card needed.
Facebook Ad Library
Google Ads Transparency