Start building

TikTok Ad Transparency Search API docs

Open Playground →

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/tiktok/ad-transparency-search
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/tiktok/ad-transparency-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "days": 30,
  "sort": "last_shown_date,desc",
  "limit": 20,
  "query": "nike",
  "offset": 0,
  "region": "DE"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable
export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

daysinteger

Number of days of Commercial Content Library history to search, from 1 to 365. Defaults to 30.

Default: 30

sortstring

Upstream sort expression. Defaults to last_shown_date,desc.

Default: "last_shown_date,desc"

limitinteger

Maximum number of ads to return, from 1 to 50. Defaults to 20. Billing is flat per request.

Default: 20

querystring

Keyword to search in TikTok's EU Commercial Content Library. Provide query or advertiserId.

cursorstring

Search cursor from a previous response's nextCursor.

offsetinteger

Zero-based result offset. Defaults to 0.

Default: 0

regionstring

Region code for the transparency search. Defaults to DE.

Default: "DE"

advertiserIdstring

TikTok Commercial Content Library advertiser ID. Provide advertiserId or query.

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.