Start building

TikTok Top Ads 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/top-ads-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/top-ads-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "page": 1,
  "limit": 20,
  "query": "glasses",
  "period": 180
}
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

querystringrequired

Keyword to search in TikTok Creative Center top video ads.

pageinteger

One-based provider page number (default 1).

Default: 1

limitinteger

Maximum number of ads requested for this page, from 1 through 20 (default 20).

Default: 20

periodinteger

Lookback period in days (default 180).

Default: 180

Possible values: 7, 30, 180

objectivestring

Campaign objective filter. Omit it to search every objective.

Possible values: traffic, app_installs, conversions, video_views, reach, lead_generation, product_sales

performanceRankstring

Ad performance percentile bucket, where top_1_20 is the highest-performing 20 percent. Omit it to search every bucket.

Possible values: top_1_20, top_21_40, top_41_60, top_61_80

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.