TikTok API

TikTok Ad transparency search API

Search TikTok's EU Commercial Content Library by keyword or advertiser ID.

POST/v1/run/tiktok.ad_transparency_search
Requests
-
30d

Pricing

One price, in dollars

Providers
Badger- served- uptime- p50$0.50/1k reqflat

Try it

Make your first request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "data": {
    "ads": [
      {
        "advertiserName": "Example title",
        "firstShownUtc": 12.5,
        "format": "example",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "lastShownUtc": 12.5,
        "status": "active",
        "videoUrl": "https://example.com/page"
      }
    ],
    "hasMore": true,
    "nextCursor": "example",
    "offset": 42,
    "region": "CA",
    "total": 12500
  },
  "found": true
}
Response interface
interface TiktokAdTransparencySearchResponse {
  data: {
    ads: {
      advertiserName?: string;
      firstShownUtc?: number;
      format?: string;
      id: string;
      image?: string;
      lastShownUtc?: number;
      status?: string;
      videoUrl?: string;
    }[];
    hasMore: boolean;
    nextCursor: string | null;
    offset: number;
    region: string;
    total: number;
  } | null;
  found: boolean;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-09-12 · uptime and latency measured over 30d
POST /v1/run/tiktok.ad_transparency_search
curl -X POST https://api.getanyapi.com/v1/run/tiktok.ad_transparency_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":30,"limit":20,"query":"nike","region":"DE"}'
FieldTypeExample value
Request body
advertiserIdstringTikTok Commercial Content Library advertiser ID. Provide advertiserId or query.
cursorstringSearch cursor from a previous response's nextCursor.
daysinteger30Number of days of Commercial Content Library history to search, from 1 to 365. Defaults to 30.
limitinteger20Maximum number of ads to return, from 1 to 50. Defaults to 20. Billing is flat per request.
offsetintegerZero-based result offset. Defaults to 0.
querystring"nike"Keyword to search in TikTok's EU Commercial Content Library. Provide query or advertiserId.
regionstring"DE"Region code for the transparency search. Defaults to DE.
sortstringUpstream sort expression. Defaults to last_shown_date,desc.
Response
dataobjectAd transparency search results and pagination, or null when no ads were found.
data.adsobject[]Commercial Content Library ad records returned for the search. Populated whenever the provider has data for the entity.
data.ads[].advertiserNamestringAdvertiser display name associated with the ad. Populated whenever the provider has data for the entity.
data.ads[].firstShownUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was first shown. Populated whenever the provider has data for the entity.
data.ads[].formatstringCommercial Content Library creative format code for the ad. Populated whenever the provider has data for the entity.
data.ads[].idstringTikTok Commercial Content Library ad identifier. Populated whenever the provider has data for the entity.
data.ads[].imagestringSigned cover image URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity.
data.ads[].lastShownUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was last shown. Populated whenever the provider has data for the entity.
data.ads[].statusstringCommercial Content Library audit status code for the ad. Populated whenever the provider has data for the entity.
data.ads[].videoUrlstringSigned video asset URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity.
data.hasMorebooleanWhether the Commercial Content Library reports more matching ads. Populated whenever the provider has data for the entity.
data.nextCursorstringSearch cursor to pass as cursor on a subsequent request, or null when there is no next page. Populated whenever the provider has data for the entity.
data.offsetintegerZero-based result offset reported for this page.
data.regionstringRegion code applied to this transparency search. Populated whenever the provider has data for the entity.
data.totalintegerTotal number of matching ads reported by the Commercial Content Library. Populated whenever the provider has data for the entity.
foundbooleanTrue when TikTok's EU Commercial Content Library returned at least one ad.
Price
Price per requestUSD$0.0005
Price /1k reqUSD$0.50

FAQ

About the TikTok Ad transparency search API

The AnyAPI TikTok Ad transparency search API returns TikTok ad transparency search data as normalized JSON from one POST call to /v1/run/tiktok.ad_transparency_search. Search TikTok's EU Commercial Content Library by keyword or advertiser ID. AnyAPI returns one normalized schema whichever source serves it. It costs from $0.50 per 1,000 requests, in US dollars with no subscription and no monthly minimum.

It costs from $0.50 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

Search TikTok's EU Commercial Content Library by keyword or advertiser ID. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.
More to call

Other TikTok endpoints

Profilefrom $1.20 /1k reqProfile videosfrom $1.20 /1k reqVideo transcriptfrom $1.20 /1k reqKeyword searchfrom $1.20 /1k reqVideofrom $0.50 /1k reqVideo commentsfrom $1.20 /1k reqUser searchfrom $1.20 /1k reqAd library adfrom $1.20 /1k reqAd library searchfrom $1.20 /1k reqAudience demographicsfrom $18.00 /1k reqComment repliesfrom $1.20 /1k reqFollowersfrom $1.20 /1k reqFollowingfrom $1.20 /1k reqHashtag videosfrom $0.80 /1k reqLivefrom $1.20 /1k reqPhotosfrom $1.20 /1k reqProfile contactfrom $1.16 /1k reqProfile regionfrom $1.20 /1k reqSearch hashtagfrom $1.20 /1k reqSearch topfrom $1.20 /1k reqSongfrom $1.20 /1k reqSong videosfrom $1.20 /1k reqTop ads searchfrom $1.20 /1k reqTrending feedfrom $1.20 /1k reqTrending hashtagsfrom $1.20 /1k reqVideo downloadfrom $1.20 /1k reqVideo transcript fullfrom $17.60 /1k req