TikTok Shop API
Search TikTok Shop products and retrieve product details, reviews, seller catalogs, shop profiles, categories, and trending products.
22 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Category
4 endpoints- Get TikTok Shop category breadcrumbs (v1)GETReturns the ancestor breadcrumb chain for category_id, ordered from the root category down, in the chosen region.
/v1/tiktok-shop/category/breadcrumbs1 cr - List TikTok Shop categories (v2)GETReturns the TikTok Shop product category tree for region, with each category's children. Use a category ID from the tree with the category products endpoint.
/v2/tiktok-shop/categories2 cr - List TikTok Shop category products (v2)GETReturns products in category_id for region. Use offset to page; hasMore says whether another page exists.
/v2/tiktok-shop/category/products2 cr - List TikTok Shop category products (v2) (v1)GETReturns products for category_id in the chosen region. The listing is a random sample of about 20: repeat calls return different products, so call again for more.
/v1/tiktok-shop/category/products1 cr
Product
10 endpoints- Get TikTok Shop home carousels (v2) (v1)GETReturns the TikTok Shop homepage product carousels and deals module for region. Carousels with products are resolved in hydrated_carousels, keyed by component_id; personalized carousels that need a signed-in shopper are omitted.
/v1/tiktok-shop/home/carousels1 cr - Get TikTok Shop product details (v2) (v1)GETReturns public product page data for product_id: title, media, SKUs and pricing, shop details, and review summary. region selects the storefront; pricing and availability are region-specific.
/v1/tiktok-shop/product/detail1 cr - Get TikTok Shop search suggestions (v2)GETReturns autocomplete and related search terms for a partial keyword, as an array of strings. lang sets the suggestion language and region the storefront.
/v2/tiktok-shop/products/search/suggestions2 cr - List more from this TikTok Shop (v2) (v1)GETReturns other products from the same seller as product_id, as shown in that product page's 'more from this shop' section for the chosen region.
/v1/tiktok-shop/product/more-from-shop1 cr - List TikTok Shop product reviews (v2) (v1)GETReturns customer reviews for product_id: ratings, text, media, and seller replies where present. One page per request: count (default 30, max 100) is the page size and page picks the page; sort and filter narrow them. Pass next_page as page for more.
/v1/tiktok-shop/product/reviews1 cr - List TikTok Shop related products (v2) (v1)GETReturns the 'you may like' recommendation carousel shown on the detail page of product_id, for the chosen region.
/v1/tiktok-shop/product/you-may-like1 cr - List TikTok Shop showcase videos (v1)GETReturns creator and affiliate showcase videos for product_id: video and cover URLs, author details, and play and like counts. region supports US only: no other storefront publishes this widget on its product pages.
/v1/tiktok-shop/product/showcase-videos1 cr - List TikTok Shop top-reviewed products (v1)GETReturns the review-ranked product list for the seller of product_id. region supports US only: no other storefront publishes this widget on its product pages.
/v1/tiktok-shop/product/top-reviewed1 cr - Search TikTok Shop products (v2)GETReturns TikTok Shop products matching keyword in the chosen region. For the next page, send load_more_params.page_token from the previous response as page_token; has_more says whether more results exist.
/v2/tiktok-shop/products/search2 cr - Search TikTok Shop products (v2) (v1)GETReturns TikTok Shop products matching keyword. Returns one page (~30); pass next_cursor as cursor within about 4 minutes for the next. region supports US only.
/v1/tiktok-shop/products/search1 cr
Search
4 endpoints- Get TikTok Shop recommended shop (v1)GETReturns the shop spotlighted in search results for keyword, together with its own product list. region supports US only.
/v1/tiktok-shop/search/recommended-shops1 cr - List TikTok Shop bought-together (v1)GETReturns the 'frequently bought together' products shown in search results for keyword. Often empty, because not every search has a bundling signal. region supports US only.
/v1/tiktok-shop/search/frequently-bought-together1 cr - List TikTok Shop recommended products (v1)GETReturns the 'recommended for you' product list shown in search results for keyword. region supports US only.
/v1/tiktok-shop/search/recommended-for-you1 cr - List TikTok Shop related search terms (v1)GETReturns the related search terms and category chips shown alongside search results for keyword. region supports US only.
/v1/tiktok-shop/search/related-terms1 cr
Shop
4 endpoints- Get TikTok Shop seller profile (v2) (v1)GETReturns the public shop profile for seller_id. Take the ID from a product detail or seller result. region supports US only.
/v1/tiktok-shop/shop/info1 cr - List TikTok Shop seller products (v2)GETReturns a seller's product catalog for seller_id in its default order. Send next_search_param from the response as search_params to get the next page; it is empty when there are no more.
/v2/tiktok-shop/seller/products2 cr - List TikTok Shop seller products (v2) (v1)GETReturns the product catalog for seller_id. Returns one page (~30); pass next_cursor as cursor within about 4 minutes for the next. region supports US only.
/v1/tiktok-shop/seller/products1 cr - Resolve TikTok Shop share link (v2)GETResolves a TikTok Shop share link to a seller_id (storefront link) or product_id (product link). resolved_url holds the redirect target. Accepts https links on vt.tiktok.com, vm.tiktok.com, www.tiktok.com or shop.tiktok.com.
/v2/tiktok-shop/shop/resolve-share-link2 cr
What you can build
- Compare product listings and seller catalogs.
- Analyze customer reviews and product showcase videos.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v2/tiktok-shop/products/search?keyword=<keyword>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.