TikTok Shop

TikTok Shop store catalog

Store info plus the product catalog (~30 products per page, with sold counts, ratings, and prices). The bulk-discovery path: walk a seller’s full catalog here, then feed product_ids into /api/v1/tiktok/shop/product for per-product detail. has_more: true means more pages exist than max_pages fetched.

Credits: 2 (refunded on failure).

get/api/v1/tiktok/shop/store

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/tiktok/shop/store
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

seller_idstring required

Numeric seller/store id (~19 digits).

max_pagesinteger

Catalog pages of ~30 products to fetch (1–10, default 1).

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

No recorded changes to this operation across all 1 revision of this API.