Get an advertiser's profile
Read an advertiser's identity: registered business name and location, who paid for their ads, the linked TikTok account with its follower count and verification type, how many ads they published in the requested window, and the countries those ads ran in. The TikTok Ad Library has no advertiser endpoint of its own — it publishes identity per ad — so this profile is assembled from the advertiser's latest matching ad, and sampledAdId names the ad it was read from.
/advertiser-profile Advertisers https://api.fetchlayer.dev/tiktok-ad-library/advertiser-profile Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
advertiser string required Registered advertiser name, or an ad library URL naming one.
country string optional Two-letter country code, or ALL for every covered country. The library covers 33 countries only — the 27 EU member states plus GB, CH, NO, IS, LI and TR. Any other country (including US, CA and AU) is rejected. (default: ALL)
Response Fields
advertiser-profile
Get an advertiser's profile
profile object The advertiser's identity record, assembled from their latest matching ad.
profile.advertiserId string Advertiser id.
profile.name string Registered business name.
profile.registeredLocation string Country the business is registered in.
profile.sponsor string Who paid for the ads, where it differs from the advertiser.
profile.accountUsername string Linked TikTok account handle. Also accountDisplayName, accountUrl and avatarUrl.
profile.followerCount string As published, for example "150.2K". A rounded figure, not an exact count.
profile.accountType string For example VERIFIED_BA for a verified business account.
profile.adCount number Ads published for this advertiser over the requested date window — not their lifetime total.
profile.countriesShown string[] Countries this advertiser's sampled ads were shown in.
profile.sampledAdId string The ad the identity details were read from, since the library publishes them per ad.
notes string[] Caveats about this result, such as an identity assembled from a thin sample.
Request
curl -X POST "https://api.fetchlayer.dev/tiktok-ad-library/advertiser-profile" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"advertiser":"Acme Beauty GmbH","country":"DE"}'Response
{
"profile": {
"advertiserId": "7203119844",
"name": "Acme Beauty GmbH",
"registeredLocation": "DE",
"accountUsername": "acmebeauty",
"followerCount": "150.2K",
"accountType": "VERIFIED_BA",
"adCount": 84,
"countriesShown": [
"DE",
"AT",
"CH"
],
"sampledAdId": "1794523310028321"
}
}