# TikTok Shop API guide ## Choose a TikTok Shop operation Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving. ### Other operations - [Creator showcase](https://www.monocrawl.com/docs/endpoints/tiktokshop/creator-showcase) — The products a TikTok creator promotes in their public showcase — creator-commerce intelligence. Paged by cursor. ### Products and categories - [TikTok Shop product](https://www.monocrawl.com/docs/endpoints/tiktokshop/product) — One TikTok Shop product: title, prices, images, sold count, rating and review count, categories, seller and SKUs. SKU-level stock is included where available; it is a source-reported value, not a guaranteed real-time inventory or checkout confirmation. - [Shop products](https://www.monocrawl.com/docs/endpoints/tiktokshop/shop-products) — Every product a TikTok Shop store lists, with prices, sales counts and ratings. Paged by cursor. ### Reviews and offers - [Product reviews](https://www.monocrawl.com/docs/endpoints/tiktokshop/product-reviews) — Reviews for a TikTok Shop product: rating, text, reviewer, SKU, verified-purchase and incentivized flags, with the product's rating summary. ### Search and discovery - [Product search](https://www.monocrawl.com/docs/endpoints/tiktokshop/search) — Search TikTok Shop products: title, image, price, units sold, rating and shop. Paged by page-number cursor. ## Check fields and collection limits Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes. Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/tiktokshop` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery. ## Endpoint reference ## tiktokshop/creator-showcase `GET /v1/tiktokshop/creator-showcase` The products a TikTok creator promotes in their public showcase — creator-commerce intelligence. Paged by cursor. *Creator showcase* | Parameter | Required | Description | | --- | --- | --- | | `handle` | yes | TikTok username without the @. — e.g. `mrtiktokreviews` | | `region` | no | Two-letter region code. The current source only serves US; other regions may return source-unavailable without a customer charge. Region is never silently changed. | | `cursor` | no | Opaque cursor from the previous page. | | `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` | ### Useful optional inputs - `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence. - `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call. - `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees. **Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key. ```bash curl "https://www.monocrawl.com/v1/tiktokshop/creator-showcase?handle=mrtiktokreviews" \ -H "x-api-key: mn_your_key_here" ``` ### Response data Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed. ```json { "cursor": null, "dropped": 0, "items": [ { "id": "example", "image": "https://example.com/example", "images": [ "example" ], "platform": "example", "price": { "amount": 0, "currency": "example", "discount_fraction": 0, "formatted": "example", "original_amount": 0, "sku_id": "example" }, "rating": 0, "review_count": 0, "seller_id": "example", "sold_count": 0, "title": "example", "url": "https://example.com/example" } ] } ``` [Field reference](https://www.monocrawl.com/docs/endpoints/tiktokshop/creator-showcase#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/tiktokshop/creator-showcase.json) ## tiktokshop/product `GET /v1/tiktokshop/product` One TikTok Shop product: title, prices, images, sold count, rating and review count, categories, seller and SKUs. SKU-level stock is included where available; it is a source-reported value, not a guaranteed real-time inventory or checkout confirmation. *TikTok Shop product* | Parameter | Required | Description | | --- | --- | --- | | `url` | yes | Product URL — e.g. `https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799` | | `region` | no | Storefront region (US is the reliable one today) — e.g. `US` | | `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` | ### Useful optional inputs - `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence. - `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees. **Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key. ```bash curl "https://www.monocrawl.com/v1/tiktokshop/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799" \ -H "x-api-key: mn_your_key_here" ``` ### Response data Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed. ```json { "categories": [ "example" ], "id": "example", "images": [], "platform": "example", "price": { "currency": "example", "currency_symbol": "example", "da_info": "example", "discount": "example", "is_interval_price": false, "max_sku_price": "example", "min_sku_original_price": "example", "min_sku_price": "example", "need_icon": false, "original_price": "example", "panel_schema": "example", "real_price": "example", "show_hot_zone": false, "symbol_position": 0 }, "rating": 0, "review_count": 0, "sale_region": "example", "seller": { "id": "example", "location": "example", "name": "example", "product_count": 0, "tiktok_url": "https://example.com/example" }, "shop": { "id": "example", "products": 0, "review_count": 0, "sold_count": 0 }, "skus": [ { "id": "example", "price": { "discount": "example", "original_price": "example", "original_price_value": "example", "real_price": {} }, "stock": 0 } ], "sold_count": 0, "title": "example" } ``` [Field reference](https://www.monocrawl.com/docs/endpoints/tiktokshop/product#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/tiktokshop/product.json) ## tiktokshop/product-reviews `GET /v1/tiktokshop/product-reviews` Reviews for a TikTok Shop product: rating, text, reviewer, SKU, verified-purchase and incentivized flags, with the product's rating summary. *Product reviews* | Parameter | Required | Description | | --- | --- | --- | | `url` | yes | Product page URL (or pass product_id). — e.g. `https://www.tiktok.com/shop/pdp/1732195276672373419` | | `product_id` | no | Product id — alternative to url. | | `region` | no | Two-letter region code. | | `cursor` | no | Page number, starting at 1. | | `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` | ### Useful optional inputs - `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence. - `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call. - `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees. **Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key. ```bash curl "https://www.monocrawl.com/v1/tiktokshop/product-reviews?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2F1732195276672373419" \ -H "x-api-key: mn_your_key_here" ``` ### Response data Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed. ```json { "count": 0, "cursor": null, "dropped": 0, "has_more": false, "items": [ { "author": "example", "country": "example", "created_at": "2026-09-01T12:00:00Z", "id": "example", "images": [ "example" ], "incentivized": false, "platform": "example", "product_id": "example", "rating": 0, "sku": "example", "text": "example", "verified_purchase": false } ], "review_count": 0 } ``` [Field reference](https://www.monocrawl.com/docs/endpoints/tiktokshop/product-reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/tiktokshop/product-reviews.json) ## tiktokshop/search `GET /v1/tiktokshop/search` Search TikTok Shop products: title, image, price, units sold, rating and shop. Paged by page-number cursor. *Product search* | Parameter | Required | Description | | --- | --- | --- | | `query` | yes | What to search for. Omit limit: there is no supported page-size control. Use cursor for continuation. — e.g. `shoes` | | `cursor` | no | Pass the returned cursor unchanged to get more results. This endpoint has no page-size control; limit is unsupported. | | `region` | no | Two-letter region code. — e.g. `US` | | `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` | ### Useful optional inputs - `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence. - `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call. - `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees. **Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key. ```bash curl "https://www.monocrawl.com/v1/tiktokshop/search?query=shoes" \ -H "x-api-key: mn_your_key_here" ``` ### Response data Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed. ```json { "count": 0, "cursor": null, "dropped": 0, "items": [ { "free_shipping": false, "id": "example", "image": "https://example.com/example", "images": [ "example" ], "platform": "example", "price": { "amount": 0, "currency": "example", "formatted": "example" }, "rating": 0, "seller_id": "example", "shop": "example", "sold_count": 0, "title": "example", "url": "https://example.com/example" } ] } ``` [Field reference](https://www.monocrawl.com/docs/endpoints/tiktokshop/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/tiktokshop/search.json) ## tiktokshop/shop-products `GET /v1/tiktokshop/shop-products` Every product a TikTok Shop store lists, with prices, sales counts and ratings. Paged by cursor. *Shop products* | Parameter | Required | Description | | --- | --- | --- | | `url` | yes | TikTok Shop store URL — e.g. `https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079` | | `sort_by` | no | top or new_releases (default top) Accepted values: top, new_releases. Case, spaces, hyphens and underscores are interchangeable. — e.g. `top` | | `region` | no | Two-letter region code (default US) — e.g. `US` | | `cursor` | no | Opaque cursor from the previous page | | `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` | ### Useful optional inputs - `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence. - `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call. - `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees. **Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key. ```bash curl "https://www.monocrawl.com/v1/tiktokshop/shop-products?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fstore%2Fgoli-nutrition%2F7495794203056835079" \ -H "x-api-key: mn_your_key_here" ``` ### Response data Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed. ```json { "cursor": null, "dropped": 0, "has_more": false, "items": [ { "id": "example", "image": "https://example.com/example", "images": [ "example" ], "platform": "example", "price": { "amount": 0, "currency": "example", "discount_fraction": 0, "formatted": "example", "original_amount": 0, "sku_id": "example" }, "rating": 0, "review_count": 0, "seller_id": "example", "sold_count": 0, "title": "example", "url": "https://example.com/example" } ], "shop": { "followers": 0, "id": "example", "logo": "example", "name": "example", "products_count": 0, "rating": 0, "region": "example", "reviews_count": 0, "sold_count": 0, "url": "https://example.com/example", "videos_count": 0 } } ``` [Field reference](https://www.monocrawl.com/docs/endpoints/tiktokshop/shop-products#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/tiktokshop/shop-products.json)