TikTok Shop API
Product search, full detail with live-stock variants, reviews with buyer photos, whole seller catalogues and the category tree — each one a single POST returning structured JSON. No seller account, no partner approval.
50 free credits on signup. No card, no seller account.
{ "data": { "query": "phone case", "products": [ { "product_id": "1732483132803683239", "title": "Pink Cherry Blossom Phone Case, Elegant Romantic Floral Style", "url": "https://shop.tiktok.com/us/pdp/1732483132803683239", "image": "https://p19-oec-general.ttcdn-us.com/...", "price": { "current": 4.88, "original": null } } ] }, "response_time": 1930, "credits_used": 1, "credits_remaining": 4735}A real captured response from this endpoint. Sign up to run your own.
What is the Scavio TikTok Shop API?
The Scavio TikTok Shop API is a REST API that returns public TikTok Shop data as structured JSON. You send a keyword, Shop URL, product id, shop id or category id to one of 8 POST endpoints with your API key, and get back products with exact prices, variants with live stock, reviews, a seller's whole catalogue or the category tree.
- 8
- endpoints, all live in production
- 1
- credit per call, every endpoint
- 8
- marketplace regions on suggestions
Start with these four
They cover most of what people build. All eight are below.
Search
POST /api/v1/tiktok-shop/searchUp to 30 products a page with title, price, canonical URL and image — the entry point for catalogue and competitor work.
Product detail
POST /api/v1/tiktok-shop/productDescription, image set and variants with live stock levels, which is the field social commerce moves fastest on.
Reviews
POST /api/v1/tiktok-shop/product/reviewsStar rating, review text, buyer photos and purchase context, paginated — social proof is most of the conversion story here.
Shop catalogue
POST /api/v1/tiktok-shop/shop/productsEverything one seller lists, 30 a page with exact prices — the fastest way to size a competitor on TikTok Shop.
All 8 TikTok Shop endpoints
Every route is a POST, returns JSON, and takes the same API key. TikTok Shop is flat-priced: 1 credit per successful call.
| Endpoint | Returns | Credits |
|---|---|---|
Resolve URL/api/v1/tiktok-shop/resolve | Any Shop URL or share link to a product_id or shop_id | 1 |
Search/api/v1/tiktok-shop/search | Up to 30 products a page — title, price, canonical URL, image | 1 |
Product detail/api/v1/tiktok-shop/product | Description, images, variants with live stock, weight | 1 |
Reviews/api/v1/tiktok-shop/product/reviews | Star rating, text, buyer photos and purchase context, paginated | 1 |
Shop catalogue/api/v1/tiktok-shop/shop/products | A seller's catalogue, 30 a page, with exact prices | 1 |
Category tree/api/v1/tiktok-shop/categories | 28 top-level categories, 240 nodes, two levels deep | 1 |
Category products/api/v1/tiktok-shop/category/products | Products under a category id, with exact prices | 1 |
Search suggestions/api/v1/tiktok-shop/search/suggestions | Keyword autocomplete across all 8 marketplace regions | 1 |
50 free credits on signup covers 50 calls of any kind. See plans
Search, or paste a link
Start from a keyword, or resolve a share link into ids first. The response on the right is a real capture, field names and all.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
res = client.tiktok_shop.search(search="phone case")
for p in res["data"]["products"]:
print(p["product_id"], p["price"]["current"], p["title"][:40])
# Paste a share link and get ids back - 1 credit
ids = client.tiktok_shop.resolve(url="https://shop.tiktok.com/us/pdp/1732483132803683239"){
"data": {
"query": "phone case",
"products": [
{
"product_id": "1732483132803683239",
"title": "Pink Cherry Blossom Phone Case, Elegant Romantic Floral Style",
"url": "https://shop.tiktok.com/us/pdp/1732483132803683239",
"image": "https://p19-oec-general.ttcdn-us.com/...",
"price": {
"current": 4.88,
"original": null
}
}
]
},
"response_time": 1930,
"credits_used": 1,
"credits_remaining": 4735
}Why not the TikTok Shop Partner API?
That one runs a shop you already own. This one reads the market you are competing in.
TikTok Shop Partner API
- Requires an approved seller or service-provider account
- Scoped to your own products, orders and inventory
- No endpoint for competitor catalogues, prices or reviews
- Onboarding runs through an application and review process
Scavio TikTok Shop API
- One API key, issued at signup — no seller account, no approval
- Any public product, seller catalogue, review or category
- Variants with live stock, and exact prices rather than banded ones
- Same key and JSON envelope as 30 other Scavio platforms
Scavio returns publicly available listing data only, and never authenticates as a TikTok user.
What developers build with it
Social commerce trend spotting
TikTok Shop is where a product goes from unknown to sold out in a week. Search a category on a schedule and watch which items appear and at what price before they reach other retailers.
search + category/productsCompetitor seller analysis
Page a rival's whole shop catalogue with exact prices to size their assortment, price bands and how fast they add SKUs.
resolve + shop/productsProduct sourcing and arbitrage
Compare TikTok Shop prices against Amazon and Walmart for the same item. Variants carry live stock, so you can tell a real winner from a listing nobody can fulfil.
product + Amazon + WalmartReview and social-proof mining
Pull reviews with buyer photos and purchase context, then run an LLM over the text for defects and sizing issues before you stock something.
product/reviewsKeyword research for listings
Search suggestions expand a partial query across all eight marketplace regions, which is the closest thing TikTok Shop has to a keyword tool.
search/suggestionsAgent commerce tools
Point an agent at the MCP server and TikTok Shop becomes a callable tool — find this product, compare prices, read reviews — with one key.
MCP + RESTHow to get TikTok Shop data as JSON
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 credits free on signup, with no card required and no TikTok Shop seller or partner account.
- 2
Resolve a link, or search
A pasted share link carries no usable id, so send {"url": "https://shop.tiktok.com/us/pdp/..."} to /api/v1/tiktok-shop/resolve to get a product_id or shop_id. If you are starting from a keyword instead, go straight to search.
- 3
Read the JSON
The response wraps the payload under data, plus credits_used and credits_remaining. Price is an object with current and original, so a discount is a comparison rather than a guess.
TikTok Shop API FAQ
What is the Scavio TikTok Shop API?
+
It is a REST API that returns public TikTok Shop data as structured JSON. Eight POST endpoints cover URL resolution, product search and suggestions, product detail with variants and stock, reviews, a seller's catalogue, the category tree and category products. You authenticate with a Scavio API key.
Who are these endpoints for?
+
Ecommerce and sourcing teams tracking social commerce; developers embedding shop data in a product; AI agent builders wiring TikTok Shop in as an MCP or SDK tool; automation engineers running price checks inside n8n, Zapier or Make; brand managers watching resellers; and analysts sizing categories. Same API for all of them.
How is this different from the TikTok Shop Partner API?
+
TikTok's Partner API is for approved sellers and service providers managing their own shop — orders, inventory, fulfilment. It does not expose competitor catalogues, prices or reviews. This reads the public storefront instead, with no seller account.
Why do I need the resolve endpoint?
+
TikTok Shop share links do not contain an id you can pass to the other endpoints. Resolve turns any Shop URL or share link into a product_id or shop_id, which is why it is step one in most workflows that start from something a human pasted.
How much does a TikTok Shop request cost?
+
Every TikTok Shop endpoint costs 1 credit, resolution and reviews included. New accounts get 50 free credits on signup, one time, with no card required. Paid plans start at $30 per month for 7,000 credits.
Which marketplace regions are covered?
+
Search suggestions expand across all eight TikTok Shop marketplace regions. Product search returns the US catalogue by default; the canonical URL in each row tells you which storefront a result came from.
What does the response look like?
+
The API wraps the payload under a data key and adds credits_used and credits_remaining. A product carries product_id, title, url, image and a price object with current and original, so a markdown is visible rather than inferred.
Do variants include stock levels?
+
Yes. Product detail returns variants with live stock alongside description, images and weight, which matters on a platform where a viral item sells out in hours.
Which languages and tools are supported?
+
Official Python (pip install scavio) and JavaScript/TypeScript (npm i scavio) SDKs, a remote MCP server at mcp.scavio.dev for AI agents, and an n8n community node. Any language can call the REST endpoints directly with an HTTP client.
Is scraping TikTok Shop data legal?
+
Scavio returns publicly available listing data and does not access seller account data or authenticate as a user. You remain responsible for how you use the data, including compliance with TikTok's terms. Talk to your own counsel for your specific use case.
Explore more of Scavio
TikTok API
Profiles, videos, comments and hashtags.
Amazon API
Search, product detail and seller offers.
Walmart API
Search, product, reviews and sellers.
Google Shopping API
Products, prices and every seller.
MCP server
Every platform as a callable tool for agents.
Pricing
Credit packs and plans, no per-platform surcharge.
Start pulling TikTok Shop data today
50 free credits on signup, no card. Your first request is a POST with a keyword in it.