TIKTOK SHOP API
User Showcase
Retrieve user showcase from TikTok Shop with a single API request.
GET
/api/data/v1/tiktok/user/showcase1credit base cost
Request parameters
Up to 1 creditThe handle of the user
Region to put the proxy in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent showcase data. Sorry for the inconvenience.
The cursor to the next page of products
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/tiktok/user/showcase?handle=mrtiktokreviews' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"products": [
{
"product_id": "1732210666230419545",
"title": "Be Bodywise Hair Growth Roll-On Serum | New Year New You Edition | 3% Rosemary, 3% Redensyl, 2% AnaGain | Precision Scalp Applicator | Paraben/Sulphate-Free | Non-Oily | DHT-Care Botanicals | 50ml",
"image": {
"height": 500,
"width": 500,
"uri": "tos-useast5-i-omjb5zjo8w-tx/b4088e56fc3140799ab2e52674339db4",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b4088e56fc3140799ab2e52674339db4~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398"
]
},
"product_price_info": {
"sku_id": "1732210669134516313",
"symbol_position": 1,
"show_currency_space": false,
"currency_show_mode": 1,
"currency_name": "USD",
"currency_symbol": "$",
"sale_price_decimal": "46.58",
"origin_price_decimal": "53",
"sale_price_format": "46.58",
"origin_price_format": "53.00",
"discount_format": "12%",
"discount_decimal": "0.12",
"single_product_price_format": "46.58",
"single_product_price_decimal": "46.58",
"sale_price_integer_part_format": "46",
"sale_price_decimal_part_format": "58",
"decimal_point_symbol": ".",
"promotion_deduction_details": {
"seller_subtotal_deduction": "6.42",
"seller_subtotal_deduction_decimal": "6.42"
}
},
"rate_info": {
"score": 4.5,
"review_count": 326
},
"sold_info": {
"sold_count": 5457
},
"seller_info": {
"seller_id": "7495572938346760281"
},
"seo_url": {
"updated_at": null,
"canonical_url": "https://www.tiktok.com/shop/pdp/1732210666230419545",
"slug": "be-bodywise-hair-growth-roll-on-serum-new-year-new-you-edition-3-rosemary-3-redensyl-2-anagain-precision-scalp-applicator-paraben-sulphate-free-non-oily-dht-care-botanicals-50ml",
"type": 2,
"version": 2
}
}
],
"cursor": "eyJwcm9kdWN0.....",
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string"
},
"title": {
"type": "string"
},
"image": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"width": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"product_price_info": {
"type": "object",
"properties": {
"sku_id": {
"type": "string"
},
"symbol_position": {
"type": "integer"
},
"show_currency_space": {
"type": "boolean"
},
"currency_show_mode": {
"type": "integer"
},
"currency_name": {
"type": "string"
},
"currency_symbol": {
"type": "string"
},
"sale_price_decimal": {
"type": "string"
},
"origin_price_decimal": {
"type": "string"
},
"sale_price_format": {
"type": "string"
},
"origin_price_format": {
"type": "string"
},
"discount_format": {
"type": "string"
},
"discount_decimal": {
"type": "string"
},
"single_product_price_format": {
"type": "string"
},
"single_product_price_decimal": {
"type": "string"
},
"sale_price_integer_part_format": {
"type": "string"
},
"sale_price_decimal_part_format": {
"type": "string"
},
"decimal_point_symbol": {
"type": "string"
},
"promotion_deduction_details": {
"type": "object",
"properties": {
"seller_subtotal_deduction": {
"type": "string"
},
"seller_subtotal_deduction_decimal": {
"type": "string"
}
}
}
}
},
"rate_info": {
"type": "object",
"properties": {
"score": {
"type": "number"
},
"review_count": {
"type": "integer"
}
}
},
"sold_info": {
"type": "object",
"properties": {
"sold_count": {
"type": "integer"
}
}
},
"seller_info": {
"type": "object",
"properties": {
"seller_id": {
"type": "string"
}
}
},
"seo_url": {
"type": "object",
"properties": {
"updated_at": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"canonical_url": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"type": "integer"
},
"version": {
"type": "integer"
}
}
}
}
}
},
"cursor": {
"type": "string"
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}