One product's GMV, orders and items sold over time, by channel, with returns and ratings
GET
/api/public/v1/tik_tok_shop/analytics/products/{productId}/performanceConnectorAnswers empty results in the documented shape until the brand switches on this connection.
Operation id getTikTokShopProductPerformance
Request
curl
curl "https://creator.growthdept.ai/api/public/v1/tik_tok_shop/analytics/products/<productId>/performance?start_date=2026-11-01&end_date=2026-11-01" \
-H "Authorization: Bearer gdc_..."Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| productId | path | string | required |
| start_date | query | string (date) | required |
| end_date | query | string (date) | required |
| granularity | query | string | One of 1DALL Default 1D |
| currency | query | string | One of USDLOCAL |
| organization_id | query | integer |
Responses
200Success
| Field | Type | Notes |
|---|---|---|
| imageUrl | string, nullable | |
| intervals | array of object | |
| intervals[].[].cancelAndRefunds | object, nullable | |
| intervals[].[].cancelAndRefunds.canceled | integer, nullable | |
| intervals[].[].cancelAndRefunds.refunded | integer, nullable | |
| intervals[].[].cancelAndRefunds.replacements | integer, nullable | |
| intervals[].[].cancelAndRefunds.returned | integer, nullable | |
| intervals[].[].endDate | string, nullable | |
| intervals[].[].gmv | object, nullable | |
| intervals[].[].gmv.amount | string, nullable | |
| intervals[].[].gmv.currency | string, nullable | |
| intervals[].[].itemsSold | integer, nullable | |
| intervals[].[].orders | integer, nullable | |
| intervals[].[].salesByChannel | array of object | |
| intervals[].[].salesByChannel[].[].avgCustomers | integer, nullable | |
| intervals[].[].salesByChannel[].[].contentType | string | |
| intervals[].[].salesByChannel[].[].gmv | object, nullable | |
| intervals[].[].salesByChannel[].[].gmv.amount | string, nullable | |
| intervals[].[].salesByChannel[].[].gmv.currency | string, nullable | |
| intervals[].[].salesByChannel[].[].itemsSold | integer, nullable | |
| intervals[].[].startDate | string, nullable | |
| intervals[].[].trafficByChannel | array of object | |
| intervals[].[].trafficByChannel[].[].avgConversionRate | string, nullable | |
| intervals[].[].trafficByChannel[].[].avgUniquePageViews | integer, nullable | |
| intervals[].[].trafficByChannel[].[].contentType | string | |
| intervals[].[].trafficByChannel[].[].ctr | string, nullable | |
| intervals[].[].trafficByChannel[].[].impressions | integer, nullable | |
| intervals[].[].trafficByChannel[].[].pageViews | integer, nullable | |
| latestAvailableDate | string, nullable | |
| productId | string | |
| ratings | array of object | |
| ratings[].[].count | integer, nullable | |
| ratings[].[].percentage | string, nullable | |
| ratings[].[].stars | string | |
| title | string, nullable |
Example
{
"imageUrl": "https://example.com/p/1",
"intervals": [
{
"cancelAndRefunds": {
"canceled": 3,
"refunded": 3,
"replacements": 3,
"returned": 3
},
"endDate": "string",
"gmv": {
"amount": "string",
"currency": "usd"
},
"itemsSold": 3,
"orders": 3,
"salesByChannel": [
{
"avgCustomers": 3,
"contentType": "string",
"gmv": {
"amount": null,
"currency": null
},
"itemsSold": 3
}
],
"startDate": "string",
"trafficByChannel": [
{
"avgConversionRate": "string",
"avgUniquePageViews": 1,
"contentType": "string",
"ctr": "string",
"impressions": 3,
"pageViews": 1
}
]
}
],
"latestAvailableDate": "string",
"productId": "string",
"ratings": [
{
"count": 3,
"percentage": "string",
"stars": "string"
}
],
"title": "string"
}Errors: 400401404422429502with an error and usually a message. See errors.
Example values are made up from each field's type and name.