---
title: "Search TikTok Shop products by keyword or category"
method: POST
path: "/social/tiktok-shop-search"
tags: ["Plugins"]
---

# Search TikTok Shop products by keyword or category

`POST /social/tiktok-shop-search`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/social/tiktok-shop-search`
- Auth: API key in header `x-scrapeunblocker-key`

Lists TikTok Shop (US) products for a keyword (`q`) or a category (`category`, URL or id). Each product card carries `productId`, `url`, `title`, `image`, `price` (current, original, discountPercent, currency, fromPrice), `rating`, `reviewCount`, `soldCount`, `brand`, `seller` (id, name, logo), promotion `labels` and, when TikTok binds one, the promoting `video` (id, url, author, play and like counts, `durationSeconds`). A keyword search also returns `relatedSearches` and `relatedCategories`; a category returns its `subcategories` and `breadcrumbs`. Up to 30 products (one page, one billed request). A keyword or category TikTok has no listing for returns 404.

## Query parameters

- `q` string, nullable: Search keyword, e.g. 'led face mask' (or a TikTok Shop keyword URL like 'https://www.tiktok.com/shop/product/led-face-mask'). Either this or `category`.
- `category` string, nullable: List a category instead of a keyword: a category URL ('https://www.tiktok.com/shop/c/beauty-personal-care/601450') or its numeric id ('601450').
- `max_results` integer: Products to return (1-30). One page is read: a keyword lists up to 30 products, a category about 15.

## Response `200`

JSON object with a `products` array.

- unknown

## Other responses

- `400`: Missing or malformed q / category, or a non-US market URL.
- `404`: TikTok has no listing for that keyword or category.
- `422`: Validation Error
- `502`: Blocked by TikTok on every proxy tried, or the call did not finish in time - retry.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)