100 free credits. No credit card required
TikTok Shop User Showcase API
Scrape TikTok Shop User Showcase data with one API call. Fetches products featured in a TikTok user's public showcase: the products a creator promotes on their profile. Each product includes title, price, rating, sold count, images, and shop details. A handle that TikTok does not resolve returns 404 at no charge; a creator who exists but promotes nothing returns an empty list. Region note: the upstream currently serves showcase lookups from the US only, so a showcase whose products are visible exclusively in another regional market can return an empty list at 0 credits.
Last updated September 2026Maintained by the SocialCrawl team
Returns the products a TikTok creator features on their profile showcase, each with title, price, images, and shop details.
Use it to see what a creator promotes rather than what a shop sells; a handle TikTok does not resolve returns 404 at no charge.
Searching 65 platforms in parallel
·TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok Shop API
What can you do with the User Showcase API?
The User Showcase endpoint gives you structured TikTok Shop data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/tiktokshop/user/showcase?handle=mrtiktokreviews"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/tiktokshop/user/showcase",
params={
'handle': 'mrtiktokreviews',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/tiktokshop/user/showcase?handle=mrtiktokreviews",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| handle | Yes | The handle of the user |
| region | No | Region the lookup is served from. Currently US only (an upstream limitation; other regions are rejected before billing). Support for more regions is planned upstream but has no date. (US) |
| cursor | No | The cursor to the next page of products |
Example Response
What does the TikTok Shop User Showcase API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "tiktokshop",
"endpoint": "/v1/tiktokshop/user/showcase",
"data": {
"items": [
{
"post": {
"id": "1729401442164511030",
"url": "https://www.tiktok.com/shop/pdp/1729401442164511030",
"content": {
"text": "BASED Hair Texture Powder | Instant Volume & Texture | Lightweight, Matte Finish | Simple, Effective, BASED.",
"media_urls": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/8d1f118bea8544ef87b77db4bfc05ba2~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398",
"thumbnail_url": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/8d1f118bea8544ef87b77db4bfc05ba2~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398",
"duration_seconds": null
},
"author": {
"username": "mrtiktokreviews",
"display_name": null,
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": null,
"ext": {
"commerce": {
"price": {
"sku_id": "1729478122049671478",
"symbol_position": 1,
"show_currency_space": false,
"currency_show_mode": 1,
"currency_name": "USD",
"currency_symbol": "$",
"sale_price_decimal": "15",
"origin_price_decimal": "30",
"sale_price_format": "15.00",
"origin_price_format": "30.00",
"discount_format": "50%",
"discount_decimal": "0.5",
"single_product_price_format": "15.00",
"single_product_price_decimal": "15",
"sale_price_integer_part_format": "15",
"sale_price_decimal_part_format": "00",
"decimal_point_symbol": ".",
"promotion_deduction_details": {
"seller_subtotal_deduction": "15.00",
"seller_subtotal_deduction_decimal": "15.00"
},
"current": 15,
"original": 30,
"currency": "USD",
"discount_percent": 50
},
"rating": {
"score": 4.4,
"review_count": 34946,
"average": 4.4,
"count": 34946
},
"sold": {
"sold_count": 523836
},
"seller_id": "7495079418085345590"
}
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
}
},
{
"post": {
"id": "1729465781365085154",
"url": "https://www.tiktok.com/shop/pdp/1729465781365085154",
"content": {
"text": "Ultimate Men's Health Bundle - Snap Supplements - Nitric Oxide Booster 60ct + Prostate Health Bundle - Natural Supplement Capsules - Support Blood Circulation & Prostate Health",
"media_urls": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/1279afe76179439dac0001e2c164c692~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398",
"thumbnail_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/1279afe76179439dac0001e2c164c692~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398",
"duration_seconds": null
},
"author": {
"username": "mrtiktokreviews",
"display_name": null,
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": null,
"ext": {
"commerce": {
"price": {
"sku_id": "1729470963795268578",
"symbol_position": 1,
"show_currency_space": false,
"currency_show_mode": 1,
"currency_name": "USD",
"currency_symbol": "$",
"sale_price_decimal": "44.95",
"origin_price_decimal": "67.95",
"sale_price_format": "44.95",
"origin_price_format": "67.95",
"discount_format": "34%",
"discount_decimal": "0.34",
"single_product_price_format": "44.95",
"single_product_price_decimal": "44.95",
"sale_price_integer_part_format": "44",
"sale_price_decimal_part_format": "95",
"decimal_point_symbol": ".",
"promotion_deduction_details": {
"seller_subtotal_deduction": "23.00",
"seller_subtotal_deduction_decimal": "23.00"
},
"current": 44.95,
"original": 67.95,
"currency": "USD",
"discount_percent": 34
},
"rating": {
"score": 4.4,
"review_count": 24858,
"average": 4.4,
"count": 24858
},
"sold": {
"sold_count": 433126
},
"seller_id": "7495134779819592674"
}
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
}
}
],
"next_cursor": "eyJwcm9kdWN0SWRzIjpbIjE3Mjk0MDE0NDIxNjQ1MTEwMzAiLCIxNzI5NDY1NzgxMzY1MDg1MTU0IiwiMTcyOTc2OTgxMzQzNTY1MDkzNyIsIjE3Mjk0Nzc3NjgxMDk0NjI2MTciLCIxNzI5NDA4MjI3NTEwNzUyMjE0IiwiMTczMjIxMDY2NjIzMDQxOTU0NSIsIjE3Mjk0MDMxNzU2Mzg5NjI1MjkiLCIxNzI5NDgxNzkxMDg4MzMyOTM1IiwiMTczMjAxNzM3OTk4NDExNzg0MSIsIjE3MjkzODkxNjc1NjIwMzUyMDkiLCIxNzI5Mzk4OTYzMDMxMDg1MzE4IiwiMTcyOTQwMTg3NzM0MzAxNTYwNCIsIjE3Mjk0OTk4NjQ4OTAyNTA2ODAiLCIxNzMxODc5MjM0OTQ4MzM4MTc0IiwiMTcyOTM4ODc5NzIyODk3ODYwNSIsIjE3MjkzOTg5NDAxMjEzMzgyODUiLCIxNzI5OTg4NDIzMTcyMDY3NDE3IiwiMTczMTUxMDY5OTYxMTU1ODA1MCIsIjE3MjkzOTkyODIyODUxODc3NTciLCIxNzI5NDcyNjQ3Njc3MDU1ODQ0Il0sIm5leHRTY3JvbGxQYXJhbSI6IjIxIn0",
"total": null,
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiZXlKd2NtOWtkV04wU1dSeklqcGJJakUzTWprME1ERTBOREl4TmpRMU1URXdNekFpTENJeE56STVORFkxTnpneE16WTFNRGcxTVRVMElpd2lNVGN5T1RjMk9UZ3hNelF6TlRZMU1Ea3pOeUlzSWpFM01qazBOemMzTmpneE1EazBOakkyTVRjaUxDSXhOekk1TkRBNE1qSTNOVEV3TnpVeU1qRTBJaXdpTVRjek1qSXhNRFkyTmpJek1EUXhPVFUwTlNJc0lqRTNNamswTURNeE56VTJNemc1TmpJMU1qa2lMQ0l4TnpJNU5EZ3hOemt4TURnNE16TXlPVE0xSWl3aU1UY3pNakF4TnpNM09UazROREV4TnpnME1TSXNJakUzTWprek9Ea3hOamMxTmpJd016VXlNRGtpTENJeE56STVNems0T1RZek1ETXhNRGcxTXpFNElpd2lNVGN5T1RRd01UZzNOek0wTXpBeE5UWXdOQ0lzSWpFM01qazBPVGs0TmpRNE9UQXlOVEEyT0RBaUxDSXhOek14T0RjNU1qTTBPVFE0TXpNNE1UYzBJaXdpTVRjeU9UTTRPRGM1TnpJeU9EazNPRFl3TlNJc0lqRTNNamt6T1RnNU5EQXhNakV6TXpneU9EVWlMQ0l4TnpJNU9UZzROREl6TVRjeU1EWTNOREUzSWl3aU1UY3pNVFV4TURZNU9UWXhNVFUxT0RBMU1DSXNJakUzTWprek9Ua3lPREl5T0RVeE9EYzNOVGNpTENJeE56STVORGN5TmpRM05qYzNNRFUxT0RRMElsMHNJbTVsZUhSVFkzSnZiR3hRWVhKaGJTSTZJakl4SW4wIiwiZSI6InRpa3Rva3Nob3AvdXNlci9zaG93Y2FzZSIsInAiOiJjdXJzb3IifQ",
"has_more": true,
"page_size": 20
},
"credits_remaining": 9999
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the TikTok Shop User Showcase API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 65 platforms covering 10B+ monthly active users.
One schema, every platform
Query 65 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I list a TikTok creator's showcase products?
Send a GET request to /v1/tiktokshop/user/showcase with the handle parameter (no @ symbol). SocialCrawl returns a paginated list of products the creator promotes on their profile, each with title, price, images, and shop details.
What is a TikTok user showcase?
A showcase is the strip of affiliated products a TikTok creator pins to their profile, typically items they sell directly or earn commission on through TikTok Shop's affiliate program.
What fields does each showcase product include?
Each product returns product id, title, price, currency, primary image URL, images array, shop id, shop name, deep link to the product page, and the creator's handle, all in the unified post list schema.
How do I paginate through a creator's full showcase?
Read the cursor field from the response and pass it as the cursor parameter on your next request. Repeat until cursor is empty to collect every product the creator currently showcases.
Why does a creator's showcase come back empty?
Some creators simply have no public showcase, but there is also a regional limit: showcase lookups are currently served from the US (an upstream limitation), so a creator whose showcase products are listed only in another regional market, such as a GB-only showcase, can return an empty list. Empty responses cost 0 credits.
How much does the TikTok Showcase API cost?
Each request costs 1 credit on the standard tier regardless of how many products are returned in the page. New accounts get 100 free credits with no credit card required.
Ask AI about SocialCrawl
Ready to scrape TikTok Shop User Showcase data?
Get your API key and start pulling TikTok Shop data in under 60 seconds.