TikTok hub

TikTok Shop Product Search API

Keyword search across the TikTok Shop catalog — product cards with price, metrics, and shop summary in the same envelope as the rest of the TikTok tag.

GET /v1/tiktok/shop/products/search

1 credit per successful request.

About this endpoint

Commerce teams tracking TikTok Shop assortment need product rows by phrase: competing SKUs, category sweeps, regional price checks. Doing that in the app UI works for a few queries; it breaks when you want scheduled keyword lists, region variants, or the same schema next to organic TikTok video and profile data.

`GET /v1/tiktok/shop/products/search` takes a required `query` string and returns matching products under `data.products`. Optional `region` picks a catalog country from the documented ISO set (for example `US`, `GB`, `DE`, `ID`, `JP`). Pagination is page-based: pass `page` (1-based) and read `data.page.hasMore` / `data.page.nextPage` for 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 finds products by keyword. For products already listed on a known shop URL, use `GET /v1/tiktok/shop/products`. 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 Product Search API FAQ

What does the TikTok Shop Product Search API return?

A page of matching TikTok Shop products under data.products, the evaluated query under data.query, totalProducts when available, and page state under data.page (currentPage, nextPage, 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 search TikTok Shop products via API?

Send GET /v1/tiktok/shop/products/search with x-api-key and a required query parameter. Optionally add region (documented country codes such as US, GB, DE, ID, JP) and page (1-based). Full parameter lists and examples are in the API docs.

How much does TikTok Shop product search 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 Shop product search the same as listing a shop's store catalog?

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

How does pagination work on TikTok Shop product search?

Pagination is page-based, not cursor-based. When data.page.hasMore is true, request the next page with page set to data.page.nextPage (or currentPage + 1). Keep the same query and region across pages.

Can I filter TikTok Shop search by country or region?

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). Omit region when you want the default catalog behavior documented for the route.

Do I need a TikTok Shop seller account to search products?

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