# SocialCrawl API — tiktokshop endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/tiktokshop

## GET /v1/tiktokshop/product
Get TikTok Shop product details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the TikTok Shop product page
- region (optional, string) — Region the proxy will be set to so you can access products from that country. Use 2 letter country codes like US, GB, FR, etc. For England, don't use UK, use GB.
curl "https://www.socialcrawl.dev/v1/tiktokshop/product?url=https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/tiktokshop/product/reviews
List TikTok Shop product reviews
Credit cost: 1 (standard)
Parameters:
- url (optional, string) — Full URL of the TikTok Shop product page
- product_id (optional, string) — The ID of the product (required if url is not provided)
- region (optional, string) — ISO 3166-1 alpha-2 region for the product (e.g. `US`). Important when the product is regionally scoped.
- Constraint: one of url, product_id (at least one required)
curl "https://www.socialcrawl.dev/v1/tiktokshop/product/reviews" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/tiktokshop/products
List TikTok Shop products
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the TikTok Shop page
- sort_by (optional, enum: top | new_releases) — Sort products by best-selling (`top`) or newest (`new_releases`). Defaults to `top`.
- region (optional, enum: US | GB | DE | FR | IT | ID | MY | MX | PH | SG | ES | TH | VN | BR | JP | IE) — Region to get shop products from. Defaults to US if not provided.
curl "https://www.socialcrawl.dev/v1/tiktokshop/products?url=https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/tiktokshop/search
Search TikTok Shop products
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword or phrase to find TikTok Shop products
- page (optional, integer) — Page number to retrieve
- region (optional, enum: US | GB | DE | FR | IT | ID | MY | MX | PH | SG | ES | TH | VN | BR | JP | IE) — Region to search shop products in.
curl "https://www.socialcrawl.dev/v1/tiktokshop/search?query=phone case" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/tiktokshop/user/showcase
List TikTok user showcase products
Credit cost: 1 (standard)
Parameters:
- handle (required) — The handle of the user
- region (optional, string) — Region to put the proxy in
- cursor (optional, string) — The cursor to the next page of products
curl "https://www.socialcrawl.dev/v1/tiktokshop/user/showcase?handle=mrtiktokreviews" \
  -H "x-api-key: sc_your_api_key_here"