TikTok Shop
TikTok Shop US through the shared marketplace schema: search, categories, a store's whole catalog, and a product with its first reviews. Prices are in USD.
Operations
| Operation | Endpoint | Returns | Price |
|---|---|---|---|
| Search | GET | POST /v1/tiktokshop/search | SearchResult | $0.001 |
| Browse | GET | POST /v1/tiktokshop/browse | SearchResult | $0.001 |
| Categories | GET | POST /v1/tiktokshop/categories | CategoryList | $0.001 |
| Catalog | GET | POST /v1/tiktokshop/catalog | SearchResult | $0.001 |
| Product | GET | POST /v1/tiktokshop/product | Product | $0.001 |
| Reviews | GET | POST /v1/tiktokshop/reviews | ReviewPage | $0.001 |
No image-search: TikTok Shop offers no visual search on the web.
All six operations cost one call each.
Things Specific to TikTok Shop
US only. Every operation serves TikTok Shop US; region other than US is a 400.
One page where TikTok Shop shows one. Search, Browse and Reviews return the page the site shows (about 30 products, 10–15 products, and five reviews) with no paging. Catalog pages through a store's whole range, 30 at a time.
Ids chain. A search item's id goes straight into Product and Reviews, and its seller.id into Catalog. Every operation also takes the page's URL.
Two prices can differ. A search or catalog item's price is what the listing shows, which can include a deal; Product reports the product page's own price per variant.