Parse a TikTok Ad Library URL
Turn any TikTok Ad Library URL into the structured filters it encodes — whether it points at one ad, one advertiser or a search, plus the country, status, media type, audience and date filters carried in its query string. A filter the URL leaves out comes back null or empty rather than defaulted, so you can tell what was actually specified. Parsing a URL does not consume a credit.
/resolve-url Utility https://api.fetchlayer.dev/tiktok-ad-library/resolve-url Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
url string required Any TikTok Ad Library URL, to be parsed into structured filters.
Response Fields
resolve-url
Parse a TikTok Ad Library URL
target string What the URL points at: ad, advertiser, search, or unknown.
adId string Present when target is ad.
advertiserName string Present when target is advertiser. advertiserId sits alongside it.
query string Present when target is search or advertiser. queryMode says which field it matched.
countries string[] Country filters carried in the URL. Empty when the URL specifies none.
adStatus string Status filter carried in the URL, or null.
mediaType string Media type filter carried in the URL, or null.
ages string[] Audience age filters carried in the URL. reach and gender sit alongside it.
shownFrom string Date window carried in the URL, YYYY-MM-DD. shownTo, sortBy and sortDirection sit alongside it.
Request
curl -X POST "https://api.fetchlayer.dev/tiktok-ad-library/resolve-url" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"url":"https://library.tiktok.com/ads?region=DE&adv_name=Acme%20Beauty%20GmbH&type=1"}'Response
{
"target": "advertiser",
"advertiserName": "Acme Beauty GmbH",
"countries": [
"DE"
],
"adStatus": null,
"ages": [],
"query": null
}