Full details of one TikTok ad by id or URL: brand, ad text, objective, countries, CTR and spend bucket, engagement, landing page and video.
2 credits/ call
Never more than 3 credits a call.
You only pay when data comes back.
curl -X POST "https://api.primaryapi.com/v1/run/tiktok.ad_library_ad" \
-H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"adId":"1881325446248609"}'{
"output": {
"found": true,
"data": {
"cost": "<integer | null>",
"ctr": "<number | null>",
"likes": "<integer | null>",
"comments": "<integer | null>", …
}
},
"credits": 2
}Input and output
1 field
1881325446248609.17 fields
Good to know
Ids come from tiktok.top_ads_search or tiktok.ad_library_search.
Creative Center terms limit automated access.
Unknown ad ID? It comes back as not found, not as an error.
The same key and credits work for every API.