# TikTok Shop Sales API (https://www.socialcrawl.dev/platforms/tiktokshop/sales)

> 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.

TL;DR: `GET /v1/tiktokshop/sales` costs Metered, 0-8 credits: each market is one /v1/tiktokshop/search page billed at that endpoint's own price (1 credit), exactly as a direct call is billed. A market whose page found nothing or failed costs nothing, and a page served from cache is free. data.regions[].credits shows each market's charge and credits_used the total. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## 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. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tiktokshop/sales" \
  --data-urlencode "query=lip gloss" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full TikTok Shop API: https://www.socialcrawl.dev/platforms/tiktokshop

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing