Start building

TikTok Top contents list 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/ads/top-contents-list
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/ads/top-contents-list" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "page": 1,
  "limit": 20,
  "country_code": "US",
  "organic_only": false,
  "order_by_metric": 1,
  "period_dimension": 3,
  "period_end_timestamp": 1793318400
}
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

period_end_timestampintegerrequired

The caller must generate this 10-digit Unix timestamp in seconds from the target ranking date, for example 1785024000; do not pass 0 because it returns an empty result

period_dimensioninteger

3/5 /Period dimension

Default: 3

country_codestring

Country code

Default: "US"

content_label_idsstring

Content label IDs, comma separated

order_by_metricinteger

Order by metric

Default: 1

organic_onlyboolean

Organic content only

Default: false

pageinteger

Page number

Default: 1

limitinteger

Items per page, max 100

Default: 20

cookiestring

Custom Cookie string (optional)

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.