Get TikTok Shop home carousels (v2)
Returns the TikTok Shop homepage product carousels and deals module for region. Carousels with products are resolved in hydrated_carousels, keyed by component_id; personalized carousels that need a signed-in shopper are omitted.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
region?string
TikTok Shop storefront to read from, such as US or GB. Results, pricing, and availability are region-specific.
Default
"US"Value in
- "US"
- "GB"
- "SG"
- "MY"
- "PH"
- "TH"
- "VN"
- "JP"
- "MX"
curl -X GET "https://example.com/v1/tiktok-shop/home/carousels" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "carousels": { "property1": null, "property2": null }, "deals": { "property1": null, "property2": null }, "hydrated_carousels": [ { "component_id": 0, "products": [ { "product_id": "string", "property1": null, "property2": null } ], "has_more": true } ], "property1": null, "property2": null }}