TikTok Top contents item detail

Name: TikTok Top contents item detail
Price: 0.001 USD
Availability: InStock
Author: TikTok

https://api.sandbase.ai/v1/api/tiktok/ads/top-contents-item-detail

Get top contents item detail on TikTok. Returns the platform data as structured JSON.

Price: $0.001USD / call
Method: POST
Response: JSON
Parameters: 2 required · 3 optional

100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Input

Item Id(string)

Video item ID

Period End Timestamp(integer)

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 Dimension(integer)

3/5 /Period dimension

Country Code(string)

Country code of the ranking

Cookie(string)

OutputReady

Your output will appear here

Complete the inputs, then click Run.

API README

TikTok Top contents item detail API

Get top contents item detail on TikTok. Returns the platform data as structured JSON.

Request

curl -X POST "https://api.sandbase.ai/v1/api/tiktok/ads/top-contents-item-detail" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id": "7684011124739656991", "period_end_timestamp": 1793318400, "period_dimension": 3, "country_code": "US"}'

The result is returned in outputs[0].data. Use an itemID from Top Contents List with the same period_end_timestamp and country_code.

Parameters

Name	Type	Required	Description
`item_id`	string	Yes	Video item ID
`period_end_timestamp`	integer	Yes	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
`cookie`	string	No	Custom Cookie string (optional)
`country_code`	string	No	Country code of the ranking
`period_dimension`	integer	No	3/5 /Period dimension

Pricing

Flat price per call. Failed calls, including lookups whose target does not exist, are not charged.

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-item-detail

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-item-detail" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "item_id": "7684011124739656991",
  "country_code": "US",
  "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

`item_id`stringrequired

Video item ID

`period_end_timestamp`integerrequired

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_dimension`integer

3/5 /Period dimension

Default: 3

`country_code`string

Country code of the ranking

Default: "US"

`cookie`string

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.

Explore more

Related APIs

All APIs

API	Price	Response
TikTok Top contents item detailThis API `TikTok`	$0.001 per call	JSON
TikTok Ad Interactive Analysis `TikTok`	$0.001 per call	JSON
TikTok Ad Keyframe Analysis `TikTok`	$0.001 per call	JSON
TikTok Ad Material Percentile Rankings `TikTok`	$0.001 per call	JSON
TikTok Ad Detail `TikTok`	$0.001 per call	JSON
TikTok Search Module Safety Configuration `TikTok`	$0.001 per call	JSON

Questions

FAQ

How do I use the TikTok Top contents item detail API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/ads/top-contents-item-detail with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the TikTok Top contents item detail API cost?

$0.001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the TikTok Top contents item detail API accept?

Required: item_id (string) and period_end_timestamp (integer). Optional: period_dimension (integer), country_code (string) and cookie (string). The Parameters table and the Playground on this page list every field.

What does the TikTok Top contents item detail API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a TikTok developer account or API key?

No. TikTok Top contents item detail runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.