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"
  }
}