Product detail
1 credit/v1/tiktokshop/productOne TikTok Shop listing by product URL. Price, rating, review count, seller, and images. Product lookup is US-only upstream.
url or product_id, region
TikTok Shop APIScrape TikTok Shop data with one API
Fetch TikTok Shop products, reviews, store lists, and creator showcases as structured JSON with one SocialCrawl API key. Same commerce schema as Amazon and Walmart. Reads are priced in credits.
/v1/tiktokshop
5 active endpoints. All standard tier.
- GET /v1/tiktokshop/product
- GET /v1/tiktokshop/product/reviews
- GET /v1/tiktokshop/products
- GET /v1/tiktokshop/search
- GET /v1/tiktokshop/user/showcase
What TikTok Shop endpoints does SocialCrawl ship?
Five live read endpoints for TikTok Shop. Product detail, reviews, store lists, keyword search, and creator showcase. Commerce data only. No checkout, inventory writes, or seller dashboards.
Product reviews
1 credit/v1/tiktokshop/product/reviewsReviews for a shop product: rating, text, author, timestamp. Page 1 only. Use url or product_id.
url or product_id, cursor, region
Shop product list
1 credit/v1/tiktokshop/productsProducts from a shop or storefront URL. Title, cover, price, sold count, reviews, rating. Sort by top or new_releases.
url, cursor, sort_by, region
Shop search
1 credit/v1/tiktokshop/searchKeyword search across TikTok Shop. Matching products with prices, ratings, and seller info. Optional region and page.
query, cursor, region
Creator showcase
1 credit/v1/tiktokshop/user/showcaseProducts a creator promotes on their public showcase. Title, price, images, shop details. US-only region for this lookup.
handle, region, cursor
TikTok Shop API5 endpoints supported
View docsReturns one TikTok Shop product: the full listing description, price and discount, rating, review count, brand, stock, shipping, and seller details.
Use it for a single known product URL or product id, remembering that lookups are served from the US, so listings sold only in other markets return 404.
1 credit
GET/v1/tiktokshop/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799&product_id=1729587769570529799
$ curl https://www.socialcrawl.dev/v1/tiktokshop/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799&product_id=1729587769570529799 \
-H "x-api-key: sc_YOUR_API_KEY"idle
// Running this live needs your own API key. Hit "Try it" to see an example responseHow the TikTok Shop API works
TikTok Shop is a normal SocialCrawl commerce surface. You call GET /v1/tiktokshop/… with an API key, spend credits on live misses, and get a single JSON envelope back. No TikTok Shop seller OAuth.
Authenticate every call
Send your key in the x-api-key header. No TikTok Shop OAuth app for public reads. The same key works across SocialCrawl platforms.
GET with query params
All TikTok Shop routes are GET. Pass url, query, handle, product_id, region, page, sort_by, cursor as query strings. We validate formats before charging.
Pay in credits, not seats
Every TikTok Shop route is standard tier: 1 credit on live miss. Cache hits cost 0. Empty or hard failures refund.
Read one JSON envelope
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.
The usual integration chain
Most products search first, deepen a product, then pull reviews. Showcase is for creator-led catalogs.
01Search
GET /v1/tiktokshop/search?query=…Product hits with prices, ratings, seller hints
Find listings by keyword before you have a product URL.
02Product
GET /v1/tiktokshop/product?url=…Product detail: price, rating, seller, images
Deepen one listing when search is not enough.
03Reviews
GET /v1/tiktokshop/product/reviews?url=…ReviewList with rating, text, author, timestamp
Voice-of-customer text sits on the review route, not product.
04Showcase
GET /v1/tiktokshop/user/showcase?handle=…Creator-promoted product cards from a handle
Affiliate and creator commerce starts from the profile showcase.
request
GET /v1/tiktokshop/search
?query=phone+case
®ion=US
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
# deepen a product
GET /v1/tiktokshop/product?url=https://www.tiktok.com/shop/pdp/…
GET /v1/tiktokshop/product/reviews?url=…response envelope
{
"success": true,
"data": {
"items": [
{
"product": {
"id": "1729587769570529799",
"title": "Example product",
"price": { "current": 19.99, "currency": "USD" },
"rating": 4.7,
"url": "https://www.tiktok.com/shop/pdp/…"
}
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}What lands in data
Field names match other SocialCrawl commerce platforms. If you parse Amazon products, you parse TikTok Shop the same way where archetypes align.
Productproduct
id, title, price, rating, review count, seller, images, url, ext (region)
ProductList / PostListproducts, search, user/showcase
items[] with title, cover, price, sold/rating, shop or creator context
ReviewListproduct/reviews
items[] with author, content.text, rating, published_at
SearchResultsearch
keyword hits with product cards and seller hints
Inside the gateway
Same request lifecycle as every other /v1 platform endpoint. TikTok Shop is not a sidecar.
- 01
Edge receives the call
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
- 02
Validate, then debit
Registry lookup finds tiktokshop/search (or product, reviews, showcase). Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before upstream work.
- 03
Cache or fetch
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the TikTok Shop read runs live. Retries on 5xx/network with a circuit breaker if the source is unhealthy.
- 04
Normalize and return
Upstream JSON is mapped to commerce archetypes (Product, ProductList, ReviewList, SellerList, App, PlaceList as applicable), validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
- Standard live miss: 1 credit
- All five shop routes: 1 credit
- Cache hit: 0 credits
- Empty / hard fail: auto-refund
- Bad params: 400, never charged
- No credits: 402, never charged
- US-only product and showcase lookups: non-US region rejected free
- Search and products: multi-region when upstream allows
- No seller write or checkout routes
How we get the data
TikTok Shop is public commerce data. We normalize it into the SocialCrawl schema so your code does not learn a second shop SDK.
What TikTok Shop is for this API
Public product listings, reviews, store catalogs, search, and creator showcases. Read-only. No checkout, inventory management, or seller auth.
How SocialCrawl reaches it
TikTok Shop paths are read live on request and normalized at our edge. The public facade is /v1/tiktokshop/* after the platform split from social TikTok.
What leaves our edge
A unified JSON envelope: success, data, credits_used, request_id, cached. Products and reviews share commerce archetypes with Amazon and Walmart where fields align.
What we do not ship live
No write endpoints. Product and showcase lookups are US-only until upstream widens regions. No full multi-page review pagination.
field map sketch
shop product card→ product.*title, price, rating, images, seller
review rows→ ReviewList items[]rating, text, author, timestamp
creator showcase→ PostList / product cardshandle-scoped products the creator promotes
What this API is used for
The jobs this API is most often used for.
5active TikTok Shop endpoints in the registry
1 creditper live read on every shop route
Creator commerce and shop product research
Callers concentrate on search to product to reviews, plus creator showcase for affiliate monitoring. Shop routes under one key with social TikTok. Product, reviews, store lists, search, and showcase without a seller app.
Shop reads are typically a few seconds on live miss. Same gateway limits as other /v1 platforms.
What people build with the TikTok Shop API
The jobs TikTok Shop data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Use case examples
Common ways teams put this data to work, and the stack each one tends to run.
Creator commerce teams
Node, cron, sheetsPull showcase products for a handle set, then deepen product detail when a SKU moves.
Competitive pricing desks
Python, notebooksSearch a category keyword by region, sample product detail and reviews for pricing and rating shifts.
Backend product jobs
Go, workers, ExplorerWire search to product to reviews into pipelines. Cache hits keep recurring runs cheap. Same key as the rest of SocialCrawl.
Call it in two lines
Standard tier is one credit per live call. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/tiktokshop/search?query=phone+case®ion=US" \
-H "x-api-key: sc_your_api_key_here"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®ion=US" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Endpoints
What data does the TikTok Shop API return?
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I build a TikTok Shop scraper?
A TikTok Shop scraper returns product listings, prices and shop search results as JSON. TikTok Shop has no public product API, so SocialCrawl exposes it through the same endpoint shape as Amazon and Google Shopping, which means one commerce schema across all three.
What can the TikTok Shop API do?
SocialCrawl gives you 5 TikTok Shop endpoints: product details, product reviews, a shop's full product list, keyword product search, and a creator's showcase. Every response comes back in the same unified schema shared across every platform.
How do I get TikTok Shop data with an API?
Send a GET request to /v1/tiktokshop/<resource> with your x-api-key. Pass a shop or product URL, a handle, or a search query depending on the endpoint. No TikTok Shop seller account, cookies, or login are required to read public shop data.
Which TikTok Shop regions are supported?
Search, store products, and product reviews support 16 regions: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, and IE. Pass the region parameter with the 2-letter ISO code; the default is US when region is omitted. Product detail and creator showcase lookups are currently served from the US only (an upstream limitation), so region accepts only US on those two endpoints for now.
How much does the TikTok Shop API cost?
Every TikTok Shop endpoint costs 1 credit per request on the standard tier, regardless of how many products or reviews a page returns. New accounts get 100 free credits with no credit card required.
Is this the same as the TikTok API?
TikTok Shop is a separate platform in SocialCrawl at /v1/tiktokshop/*, split out from the social TikTok endpoints. The old /v1/tiktok/shop/* paths still resolve for existing integrations, but new code should call the tiktokshop routes.
Is there a TikTok Shop data API?
Yes, on two levels. TikTok runs an official TikTok Shop Partner API, but it is gated to approved sellers and scoped to managing your own shop, orders, and fulfilment. To read public TikTok Shop data without a seller account, SocialCrawl exposes 5 endpoints, product details, product reviews, a shop's full product list, keyword product search, and a creator's showcase, all in one unified schema for 1 credit per call. Search and store catalogs cover 16 shop regions.
Is scraping TikTok Shop data legal?
SocialCrawl returns publicly available TikTok Shop data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with TikTok Shop's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
TikTok Shop scraping API vs the official TikTok Shop API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call TikTok Shop endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.
Ask AI about SocialCrawl