TikTok Shop Sales API
Scrape TikTok Shop Sales data with one API call. Runs one keyword through TikTok Shop search in each market you name and returns, per market: how many listings came back (`listings`, `listings_with_sales`), their lifetime units sold added up (`units_sold`), an estimate of sales in the market's own currency (`estimated_sales`, each listing's units times its current price, `currency`), and the top listings by units (`top_products`, each with id, title, url, price, units_sold and estimated_sales). These are lifetime units of the listings on the first search page at today's price, and TikTok can return a different first page on a repeat call, so compare markets within one call; the figures are not a period total or the whole market. For sales over a period, call it on a schedule and take the difference between two calls. Each market is one call to /v1/tiktokshop/search at that endpoint's own price, so every row behind the numbers is the row that endpoint returns; a market that found nothing or failed costs nothing and reports `status` `empty` or `failed` with null figures, never 0. `data.regions[].credits` and `request_id` show each market's own call.
Last updated October 2026Maintained by the SocialCrawl team
Returns units sold and estimated sales per TikTok Shop market for a keyword, with the top listings by units, from each market's first search page.
Use it to compare how much of a product sells in each country in one call; search returns the listings themselves.
Searching 68 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 SearchTikTok·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·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·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 SearchWhat can you do with the Sales API?
The Sales 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/sales?query=lip+gloss®ions=US%2CGB%2CMY"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/tiktokshop/sales",
params={
'query': 'lip gloss',
'regions': 'US,GB,MY',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/tiktokshop/sales?query=lip+gloss®ions=US%2CGB%2CMY",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| query | Yes | Product keyword, sent unchanged to each market's search (1-200 characters). |
| regions | No | Comma-separated markets, up to 8: US, GB, DE, FR, IT, ES, IE, ID, MY, MX, PH, SG, TH, VN, BR, JP. Default US. Each market costs one search page (1 credit) when it returns listings. |
| top | No | How many top listings by units to return per market, 1 to 20. Default 5. |
What does the TikTok Shop Sales 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/sales",
"data": {
"query": "lip gloss",
"method": "Lifetime units sold of the listings on TikTok Shop's first search page in each market, multiplied by each listing's current price. A listing with no units or no price is counted in listings but not in the estimate.",
"methodology_version": "2026-10-02",
"regions": [
{
"region": "US",
"status": "ok",
"http_status": 200,
"listings": 30,
"listings_with_sales": 28,
"units_sold": 434153,
"estimated_sales": 5002982.82,
"currency": "USD",
"top_products": [
{
"id": "1731896769144001226",
"title": "Hydrating Lip Gloss - High Shine & Tinted, Infused with Hyaluronic Acid, Jojoba Oil & Shea Butter",
"url": "https://www.tiktok.com/shop/pdp/1731896769144001226",
"price": 8.95,
"units_sold": 118141,
"estimated_sales": 1057361.95
},
{
"id": "1729549925196665361",
"title": "JUDYDOLL Ice Watery Lip Gloss, Blur, Mirror Lip Glaze, Glossy Lip Stain, Transfer-Proof, Metal Applicator, Waterproof, Long-Lasting, Moisturizing Shine, Hydrating, Buildable Color, Plumping, Not Easy To Fade, Lightweight, Summerwins",
"url": "https://www.tiktok.com/shop/pdp/1729549925196665361",
"price": 7.99,
"units_sold": 114872,
"estimated_sales": 917827.28
}
],
"credits": 1,
"request_id": "req-oLmU5mToiDnFKazk"
},
{
"region": "GB",
"status": "ok",
"http_status": 200,
"listings": 45,
"listings_with_sales": 40,
"units_sold": 361901,
"estimated_sales": 2964245.9,
"currency": "GBP",
"top_products": [
{
"id": "1729428926100703968",
"title": "P.Louise Stay Shining Crown Lip Oil",
"url": "https://www.tiktok.com/shop/pdp/1729428926100703968",
"price": 5,
"units_sold": 162807,
"estimated_sales": 814035
},
{
"id": "1729785552669939890",
"title": "[Dr.Melaxin Official] BP Spicule Plumping LIP Shot - Maxi | Lip Plumper Volumizing Non-Sticky Glossy Lip Volumizer | Korean Cosmetics",
"url": "https://www.tiktok.com/shop/pdp/1729785552669939890",
"price": 10.69,
"units_sold": 86531,
"estimated_sales": 925016.39
}
],
"credits": 1,
"request_id": "req-OTCFtE4JX4DXmUKu"
}
],
"sales_status": "complete",
"credits_charged": 3
},
"credits_used": 3,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-03T18:35:23.916Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the TikTok Shop Sales 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
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 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(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape TikTok Shop Sales data?
Get your API key and start pulling TikTok Shop data in under 60 seconds.