GET Get Bestselling Creators
Get Bestselling Creators Shop Required scope: data.bestselling.public.read Get the top 100 performing creators of the target date range Version 202511
GET/analytics/202511/creators/bestselling
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| date Required | string | The reference date (ISO 8601 YYYY-MM-DD format) in the shop’s registered timezone.The query will calculate data backwards from this specified date based on the time_slot parameter (e.g., if time_slot is 7D, it returns data for the 7 days ending on this date). This date is inclusive. The maximum query range depends on the time_slot parameter. |
| time_slot Required | string | Specifies the query time range. Supported values are:- 1D — query data for 1 day- 7D — query data for 7 days- 30D — query data for 30 daysThis field determines the maximum range that can be queried using the date field. |
| author_type Required | string | The creator's user type. This is an enumerated type with values:OFFICIAL, CHANNEL, AFFILIATEIf not provided, it will default to all. |
| currency | string | USD or LOCAL |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | Empty. No business logic error codes. |
Is this content helpful?Helpful
Not Helpful
PreviousNext