# TikTok Shop (/docs/tiktokshop)



TikTok Shop [#tiktok-shop]

Extract TikTok Shop products, product reviews, shop search results, and creator showcases.

TikTok Shop is TikTok's commerce surface. These endpoints are separate from the [TikTok social API](/docs/tiktok.md) so you can pull product and seller data without touching the social graph.

Base URL: `/v1/tiktokshop/...`

How do I get started with TikTok Shop data? [#how-do-i-get-started-with-tiktok-shop-data]

1\. Search for products [#1-search-for-products]

```bash
curl "https://www.socialcrawl.dev/v1/tiktokshop/search?query=phone%20case&region=US" \
  -H "x-api-key: sc_your_api_key_here"
```

2\. Fetch a product's details [#2-fetch-a-products-details]

```bash
curl "https://www.socialcrawl.dev/v1/tiktokshop/product?url=https://www.tiktok.com/shop/pdp/..." \
  -H "x-api-key: sc_your_api_key_here"
```

3\. Read computed fields [#3-read-computed-fields]

When an endpoint supports a computed field and the required source inputs are present, the unified response includes that optional field. Depending on the endpoint, optional fields can include `engagement_rate`, `language`, `content_category`, and `estimated_reach`. See [Computed fields](/docs/computed-fields.md) for formulas, clamping rules, and null semantics.

What TikTok Shop data can I access? [#what-tiktok-shop-data-can-i-access]

Five endpoints, all `GET`, all 1 credit:

* **`GET /v1/tiktokshop/search`** — keyword to products. The entry point when you have nothing but a term.
* **`GET /v1/tiktokshop/product`** — full detail for one listing from its `url`.
* **`GET /v1/tiktokshop/product/reviews`** — a listing's reviews, addressed by **`url` or `product_id`**; one of the two is required. Once search has given you a `product_id`, this is the cheaper key to carry around.
* **`GET /v1/tiktokshop/products`** — everything one shop sells, from the store `url`. `sort_by` is `top` (best-selling, the default) or `new_releases`. Only page 1 is returned: the upstream cursor is not currently exposed on this endpoint.
* **`GET /v1/tiktokshop/user/showcase`** — the products a creator has pinned to their own showcase, by `handle`. This is the endpoint that connects a creator to what they actually sell, and it pages with `cursor`.

```bash
# Reviews by product_id — no need to re-resolve the URL
curl "https://www.socialcrawl.dev/v1/tiktokshop/product/reviews?product_id=1729382476598" \
  -H "x-api-key: sc_your_api_key_here"

# Everything one shop sells
curl "https://www.socialcrawl.dev/v1/tiktokshop/products?url=https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079&sort_by=top" \
  -H "x-api-key: sc_your_api_key_here"

# What a creator is promoting on their own showcase
curl "https://www.socialcrawl.dev/v1/tiktokshop/user/showcase?handle=charlidamelio&region=US" \
  -H "x-api-key: sc_your_api_key_here"
```

<PlatformEndpoints platform="tiktokshop" />

What should I know about TikTok Shop data? [#what-should-i-know-about-tiktok-shop-data]

* All endpoints use `GET` method with query parameters
* Authentication via `x-api-key` header
* Responses follow the unified SocialCrawl schema
* The legacy `/v1/tiktok/shop/*` and `/v1/tiktok/user/showcase` paths still resolve for backward compatibility, but new integrations should use `/v1/tiktokshop/...`

Which regions does each endpoint support? [#which-regions-does-each-endpoint-support]

Region support differs per endpoint because the upstream serves the two lookup endpoints from the US only:

* `search`, `products`, and `product/reviews` accept a `region` parameter with 16 two-letter codes (US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE). Use `GB` for the United Kingdom, not `UK`.
* `product` and `user/showcase` currently accept `region=US` only. This is an upstream limitation, not a plan restriction: any other value returns a clear `400` before billing (0 credits). A listing sold only in a non-US market resolves as `404`, and a showcase whose products are listed only outside the US can return an empty list at 0 credits.
* To work with non-US listings today, find them with `search` (scoped by `region`) and read their reviews with `product/reviews` by `product_id`. Full product-detail lookups outside the US will light up as soon as the upstream ships regional coverage.