List TikTok Shop store products
Get products listed in a TikTok Shop store.
Headers
Get your API keyAPI key (`sfk_...`)
Public TikTok Shop store URL whose products should be listed.
min 1 chars · max 4096 chars
Pagination cursor from a previous response. Omit to request the first page.
min 1 chars · max 8192 chars
Optional region code for the shop catalog. When omitted, the default catalog region is US.
one of: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE
Endpoint-specific response payload.
Whether the storefront resolved for this request.
one of: found, not_found
Store summary when `lookupStatus` is `found`; null when the store could not be resolved.
Shop seller identifier, when available.
min 1 chars
Shop display name, when available.
min 1 chars
Shop logo image URL, when available.
min 1 chars
Canonical public URL for the shop storefront, when available.
min 1 chars
Region code reported for the storefront, when available.
min 1 chars
Average shop rating, when available.
≥ 0
Approximate units sold for the shop, when available.
≥ 0
Number of shop reviews, when available.
≥ 0
Count of products currently on sale, when available.
≥ 0
Follower count for the shop, when available.
≥ 0
Video count associated with the shop, when available.
≥ 0
Product cards 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.
Pagination state for the current response.
Opaque cursor to pass as `cursor` on the next request when `hasMore` is true; otherwise null.
min 1 chars
Whether another page of products can be requested for this store.
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?url=https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" \
-H "x-api-key: YOUR_API_KEY"Responses
Store listing result. `data.lookupStatus` is `not_found` when the storefront cannot be resolved.