Social Fetch
Get API key
TikTok hub

TikTok Shop Store Products API

Page the product catalog for one public TikTok Shop storefront — store summary plus product cards in the same envelope as the rest of the TikTok tag.

GET /v1/tiktok/shop/products

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Competitor watchlists and assortment audits usually start with a store link, not a keyword. You already know the seller; you need every listed SKU, current prices, and sold/rating signals without walking the storefront in a browser for each refresh.

`GET /v1/tiktok/shop/products` takes a required public shop `url` and returns `data.lookupStatus` (`found` / `not_found`), a store summary under `data.shop` when resolved, and product cards under `data.products`. Optional `region` selects a catalog country from the documented ISO set (for example `US`, `GB`, `DE`, `ID`, `JP`; default catalog region is US when omitted). Pagination is cursor-based: when `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` on the next call. Each product can include title, URL, image, ship-from text, trust and promo labels, price (current / original / discount text), metrics (sold, reviews, rating), and a shop summary. Bill from `meta.creditsCharged`; the flat amount for this operation is on this page and in the OpenAPI note.

This route lists products for one known store. Keyword discovery across the Shop catalog is `GET /v1/tiktok/shop/products/search`. For one product URL or id, use `GET /v1/tiktok/products`. For reviews on a product, use `GET /v1/tiktok/products/reviews`. Creator showcase shelves are `GET /v1/tiktok/profiles/{handle}/showcase-products`. Same Social Fetch API key for all of them.

TikTok Shop Store Products API FAQ

What does the TikTok Shop Store Products API return?

lookupStatus (found or not_found), a shop summary under data.shop when the storefront resolves (id, name, logoUrl, storeUrl, region, rating, soldCount, reviewCount, onSellProductCount, followerCount, videoCount), product cards under data.products, and cursor page state under data.page (nextCursor, hasMore). Each product can include id, title, description, url, image fields, shipFrom, trustLabel, labels, price, metrics (sold, reviews, rating), and shop (id, name, logoUrl). Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I list products for a TikTok Shop store via API?

Send GET /v1/tiktok/shop/products with x-api-key and a required url parameter pointing at the public storefront. Optionally add region (documented country codes such as US, GB, DE, ID, JP) and cursor from a previous page. Full parameter lists and examples are in the API docs.

How much does listing TikTok Shop store products cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.

Is listing a shop's catalog the same as Shop product search?

No. GET /v1/tiktok/shop/products lists products for one shop when you already have that shop's public URL. GET /v1/tiktok/shop/products/search finds products by keyword across the Shop catalog.

How does pagination work on TikTok Shop store products?

Pagination is cursor-based. When data.page.hasMore is true, request the next page with cursor set to data.page.nextCursor. Keep the same url and region across pages. Omit cursor for the first page.

What happens when the store URL cannot be resolved?

lookupStatus is not_found, data.shop is null, and products is empty. Branch on lookupStatus before writing rows so a bad or private store URL does not look like an empty catalog.

Can I pick a catalog country when listing store products?

Yes. Pass an optional region query parameter using one of the documented codes (US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE). When omitted, the default catalog region is US.

Do I need a TikTok Shop seller account to list store products?

No. You authenticate to Social Fetch with an API key. The route reads public storefront catalog data; it does not act on behalf of a seller account you manage.

Other TikTok endpoints