tiktok/creator/product-analytics-list

Name: Get Creator Product List Analytics
Author: TikTok

Retrieve the list of products promoted by a TikTok Shop creator account within a specified time range, along with their sales analytics.. Supports sorting by revenue or product publish time and allows pagination.

Input

Cookie(string)

End Date(string)

End date, formatted as 'YYYY-MM-DD', e.g., '2025-05-01'

Page(integer)

Page number, default is the first page `0`

Proxy

Optional HTTP proxy address, can be omitted if not used

Start Date(string)

Start date, formatted as 'YYYY-MM-DD', e.g., '2025-04-01'

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDtiktok/creator/product-analytics-list

Input Schema

5 parameters · 0 required · 5 optional

Parameter	Type	Required	Description
`page`	integer	Optional	Page number, default is the first page `0`
`proxy`	union	Optional	Optional HTTP proxy address, can be omitted if not used
`cookie`	string	Optional	User Cookie string for authentication
`end_date`	string	Optional	End date, formatted as 'YYYY-MM-DD', e.g., '2025-05-01'
`start_date`	string	Optional	Start date, formatted as 'YYYY-MM-DD', e.g., '2025-04-01'

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Code Examples

Ready-to-run snippets

curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "tiktok/creator/product-analytics-list",
  "prompt": "a beautiful sunset over mountains"
}'

← Back to Get Creator Product List Analytics

API README

Get Creator Product List Analytics

Retrieve the list of products promoted by a TikTok Shop creator account within a specified time range, along with their sales analytics. Supports sorting by revenue or product publish time and allows pagination. It is suitable for tiktok workflows.

Capability

Common use cases

Enrich profiles, accounts, and business records with structured context.
Create repeatable integrations that pass structured results to downstream business systems.
Support scheduled jobs, internal tools, and agent workflows with structured results.

Related Models

tiktok/creator/account-health-statusRetrieve the health status of a TikTok Shop creator account, including the health score over the past 90 days and the current number of accumulated violation points.. About violation points: Violation points are key metrics used by TikTok to measure the health of a creator account.. Higher violation points indicate worse account health, and may lead to restrictions such as reduced exposure, suspension, or account bans.. Violation points directly impact the account’s visibility and recommendation on the platform.tiktok/creator/account-insights-overviewRetrieve performance overview of a TikTok Shop creator account within a specified date range, including metrics like revenue, exposure, clicks, and orders.. By default, it aggregates data from the month of `start_date` (e.g., if `start_date` is 2025-04-01, it retrieves data for the entire month of April).tiktok/creator/account-violation-listRetrieve the violation history of a TikTok Shop creator account, providing details about past violations and corresponding enforcement actions.. Pagination is supported to retrieve multiple records in chronological order.. Suitable for creator account risk management, health monitoring, and compliance auditing.tiktok/creator/creator-account-infoRetrieve basic information of a TikTok Shop creator account, including username, avatar URLs, account ID, register region, partner binding info, and permission list.. Useful for verifying account status, displaying user profile data, checking partner binding status, and determining access permissions for business processes.tiktok/creator/live-analytics-summaryRetrieve a summary of live streaming performance for a TikTok Shop creator account within a specified time range.. By default, it covers one full calendar month starting from the provided `start_date` (e.g., input `04-01-2025` will fetch data for the entire April 2025).tiktok/creator/product-related-videosRetrieve the list of all videos associated with a specified product along with their interaction metrics (such as like count, comment count, share count).. Useful for analyzing the promotional effectiveness and differences of the same product across different creators' videos.. Supports time-based filtering, defaulting to the calendar month of the specified start_date.tiktok/creator/showcase-product-listRetrieve the list of products currently displayed in a TikTok Shop creator's showcase.. Useful for product management, analytics, and monitoring promoted items.tiktok/creator/video-analytics-summaryRetrieve a video performance overview for a TikTok Shop creator account over a specified time range.. By default, the API fetches data for the past 30 days (or full calendar month based on the platform settings).. Useful for analyzing metrics like video count, views, new followers, and generated GMV.