scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTProduct
  • POSTProduct Reviews

TikTok Product

1 credit

Get product details from TikTok Shop.

POST/api/v1/tools/tiktok/product

Parameters

productUrlstringrequired

TikTok Shop product URL or product ID. Accepts a full URL or a bare numeric product ID.

fieldsstring[]

Fields to include in the product object. Omit for defaults: productId, name, descriptionText, soldCount, totalReviews, averageRating, price, currencySymbol, categories, shopName, shopRating. Use ["*"] for all fields. Available fields: productId, name, descriptionText, soldCount, totalReviews, averageRating, price, currencySymbol, categories, shopName, shopRating, descriptionImages, ratingDistribution, images, videos, saleProperties, productProperties, unitPrice, currencyName, skus, shippingOptions, deliveryMinDays, deliveryMaxDays, codAvailable, agingDisplayStatus, shopId, shopSoldCount, shopSoldCountRaw, shopProductCount, shopLogo, shopLink, shopDescription, shopRegion, shopReviewCount, shopFulfillmentScore, shopFulfillmentScoreRaw, shopFulfillmentHighlight, shopResponseScore, shopResponseScoreRaw, shopResponseHighlight, shopWorstRating, shopBestRating, legitWarnings, benefitInfo, promotionLabels, scrapedAt.

Response Schema

dataobject

TikTok product result

productobject

Product object. Fields depend on the fields parameter. Default fields: productId, name, descriptionText, soldCount, totalReviews, averageRating, price, currencySymbol, categories, shopName, shopRating.

metaobject

Request metadata

toolstring

Tool name (tiktok-product)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tiktok/product \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"productUrl": "https://www.tiktok.com/shop/us/pdp/product/1729512345678901234"
}'

Response Example

{
"data": {
"product": {
"productId": "1729512345678901234",
"name": "Wireless Bluetooth Earbuds",
"descriptionText": "High-quality wireless earbuds with noise cancellation...",
"soldCount": 15420,
"totalReviews": 3280,
"averageRating": 4.6,
"price": "29.99",
"currencySymbol": "$",
"categories": [
{
"id": "1001",
"name": "Electronics",
"level": 1,
"isLeaf": false,
"parentId": "0"
}
],
"shopName": "TechDeals Official",
"shopRating": "4.8"
}
},
"meta": {
"tool": "tiktok-product",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}