Headers
Get your API keyAPI key (`sfk_...`)
Search query text for TikTok Shop products.
min 1 chars · max 512 chars
1-based results page number. Omit to request the first page. Pagination is page-based.
≥ 1
Optional country or region code for the product search catalog.
one of: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE
Endpoint-specific response payload.
Search query that was evaluated for this response.
Products returned for the requested page.
TikTok Shop product identifier.
min 1 chars
Product title text.
min 1 chars
Product description, when available.
Canonical public URL for the product page, when available.
min 1 chars
Primary product image URL, when available.
min 1 chars
Structured image size metadata when the image URL is available.
Image width in pixels, when available.
≥ 0
Image height in pixels, when available.
≥ 0
Primary product image URL.
Reported ship-from location text, when available.
TikTok Shop trust badge label, when available.
Promotional, shipping, and trust labels for the product card.
Label text shown for the product.
TikTok Shop label type code, when available.
Displayed price data.
Currency name or code for displayed prices, when available.
Currency symbol for the listed price, when available.
Current sale price for the product, when available.
Original or list price before discount, when available.
Human-readable discount label, when available.
Human-readable savings line, when available.
Rating and sales metrics for the product.
Approximate units sold, when available.
≥ 0
Number of product reviews, when available.
≥ 0
Average product rating, when available.
≥ 0
Selling shop for the product.
TikTok Shop seller identifier, when available.
Shop display name, when available.
Shop logo image URL, when available.
Total matching products reported for the search, when available.
≥ 0
Pagination state for the current response.
1-based page number for this response.
≥ 1
Next page number to request when more results are available; otherwise null.
≥ 1
Whether more product pages are likely available for this search.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/tiktok/shop/products/search?query=shoes" \
-H "x-api-key: YOUR_API_KEY"Responses
Product search results for the requested page.