TikTok Ad Library Supported Regions API
List the countries the library covers, with their codes.
- 10 credits per call
- Failed calls are free
- Updated
- tiktok-adlibrary.regions.list
{ "total_items": 33, "items": [ { "name": "Austria", "code": "AT" }, { "name": "Belgium", "code": "BE" } ]}
| # | Country | Code |
|---|---|---|
| 1 | Austria | AT |
| 2 | Belgium | BE |
| 3 | Bulgaria | BG |
| 4 | Switzerland | CH |
| 5 | Cyprus | CY |
| 6 | Czech Republic | CZ |
| 7 | Germany | DE |
| 8 | Denmark | DK |
| 9 | Estonia | EE |
| 10 | Spain | ES |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].name | string | The advertiser's name. | Austria |
| items[].code | string | The country code. | AT |
| items | array | The results. | 33 records |
| total_items | integer | How many results this response holds. | 33 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
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.regions.list", "input": {}}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tiktok-adlibrary.regions.list", "input": {}}''')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.regions.list", "input": {}}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, list the countries the TikTok Ad Library covers.
More from the TikTok Ad Library API
TikTok Ad Library Supported Regions API FAQ
The short answers. The docs have the long ones.
How much does the TikTok Ad Library Supported Regions API cost?
10 credits per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Every input is optional; the input fields below list what each one does.
Do I need a TikTok Ad Library login?
No. It reads public TikTok Ad Library data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds tiktok-adlibrary.regions.list, checks its price and runs it with the same credits as the REST API.
Your first TikTok Ad Library call is free.
Up to 100 free credits to start, no card needed.