> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shop Product Detail

> Full TikTok Shop product page: description, images, price, SKUs with stock, reviews, shop stats and TikTok's AI summary.

<Note>
  `skus` carry per-variant `properties`, `price`, `available_quantity` and `in_stock`; `reviews` ship with `rating_breakdown` and `shop` with the store's sold/follower/review counts. Unknown ids return `404`.
</Note>

<Note>
  On some promoted products TikTok masks the page price (it ships `"1*"`): `price.amount` is then `null` while `price.discount` is set. The list endpoints carry the real price.
</Note>

<Note>
  **US market only** — TikTok Shop resolves the market from the visitor's location and these endpoints read the US storefront (prices in USD). Lists return what the storefront page renders; there is no further pagination.
</Note>

<Note>
  Each request costs **8 credits**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/tiktok/shop/products/{product_id}
openapi: 3.1.0
info:
  title: ScrapeBadger TikTok API
  version: 1.0.0
  description: >-
    TikTok scraping API for user profiles, videos, comments, transcripts,
    hashtags, music/sounds, search, trending, and the EU Commercial Content (ad
    transparency) library. Returns clean structured JSON; handles signing,
    anti-bot bypass, and regional proxy routing automatically.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/tiktok/shop/products/{product_id}:
    get:
      tags:
        - TikTok Shop
      summary: Shop Product Detail
      description: >-
        Full product page: description, images, price, SKUs with stock, reviews
        with rating breakdown, shop stats, seller business identity and TikTok's
        AI summary. On some promoted products TikTok masks the page price
        (price.amount is null while price.discount is set); the list endpoints
        carry the real price. US market only (prices in USD); lists carry what
        the storefront page renders, with no further pagination.
      operationId: getTikTokShopProduct
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            Numeric TikTok Shop product id (from ranking, category or search
            results).
      responses:
        '200':
          description: Shop Product Detail
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShopProductResponse'
              example:
                product:
                  product_id: '1729448464509734958'
                  title: Toplux Magnesium Complex 8 Essential Magnesium Supplement
                  url: >-
                    https://shop.tiktok.com/us/pdp/magnesium-complex-by-toplux-8-essential-magnesium-forms-in-one-capsule/1729448464509734958
                  description: >-
                    Boost your wellness routine with Magnesium Complex, an
                    essential supplement for your health. 



                    Designed to provide you ...
                  description_images:
                    - >-
                      https://p16-oec-general-useast8.ttcdn-us.com/tos-useast8-i-rt0ujvrtvp-tx2/81918e8144f0419f9591088c770a9d34~tplv-fhlh96nyum-origin-jpeg.jpeg?dr=12178&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=useast5&from=2739998086
                  images:
                    - >-
                      https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/0b7d3556b58d451daa2fab65d1eedf91~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839
                    - >-
                      https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b0d48a39d1a74e819f72533190b841bf~tplv-fhlh96nyum-crop-webp:2200:2200.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839
                  price:
                    amount: null
                    original: null
                    discount: 66%
                    currency: USD
                    symbol: $
                  rating: 4.6
                  review_count: 157838
                  sold_count: 2023642
                  categories:
                    - id: '700645'
                      name: Health
                      slug: all
                      level: 1
                      is_leaf: false
                      parent_id: '0'
                      image: null
                      url: https://shop.tiktok.com/us/c/all/700645
                    - id: '700646'
                      name: Nutrition & Wellness
                      slug: all
                      level: 2
                      is_leaf: false
                      parent_id: '700645'
                      image: null
                      url: https://shop.tiktok.com/us/c/all/700646
                    - id: '700650'
                      name: Vitamins, Minerals & Wellness Supplements
                      slug: all
                      level: 3
                      is_leaf: false
                      parent_id: '700646'
                      image: null
                      url: https://shop.tiktok.com/us/c/all/700650
                    - id: '1299984'
                      name: Mineral Supplements
                      slug: all
                      level: 4
                      is_leaf: true
                      parent_id: '700650'
                      image: null
                      url: https://shop.tiktok.com/us/c/all/1299984
                  sale_properties:
                    Specifications:
                      - Default
                  attributes:
                    'CA Prop 65: Repro. Chems': 'No'
                    'CA Prop 65: Carcinogens': 'No'
                    Dietary Supplement Disclaimer: 'Yes'
                  skus:
                    - sku_id: '1729448464509800494'
                      properties:
                        Specifications: Default
                      price:
                        amount: null
                        original: null
                        discount: 66%
                        currency: USD
                        symbol: $
                      available_quantity: 938
                      in_stock: true
                      image: null
                  reviews:
                    - review_id: '7636473773830670093'
                      rating: 2
                      text: Es muy bueno, el magnesio para el dolor en el cuerpo
                      reviewer_name: Ⓜ**3
                      created_utc: 1778005121
                      is_verified_purchase: true
                      is_incentivized: false
                      sku: Default
                      images:
                        - >-
                          https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/9f460e5abeb840169cce1f0fea3849b0~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839
                      created_at: '2026-05-05T18:18:41Z'
                      country: US
                  rating_breakdown:
                    '1': 9870
                    '2': 2689
                    '3': 6561
                    '4': 13687
                    '5': 125031
                  shop:
                    id: '7495620301677955118'
                    name: Toplux Nutrition
                    logo: >-
                      https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/35e90bd8b9764783a6b730c75daebc18~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&t=555f072d&ps=933b5bde&shp=905da467&shcp=607f11de&idc=useast5&from=2422056039
                    url: >-
                      https://shop.tiktok.com/us/store/toplux-nutrition/7495620301677955118
                    rating: 4.5
                    sold_count: 3655070
                    product_count: 22
                    review_count: 268574
                    followers_count: 134963
                    video_count: 1397
                  seller_business_name: Lux Global Inc
                  seller_business_address: >-
                    1146 N Central Ave, Glendale, California, 91202, The United
                    States of America
                  ai_summary:
                    aigc_title: Toplux Magnesium Complex Capsules, 8 Forms...
                    aigc_description: >-
                      Toplux Magnesium Complex delivers eight essential forms of
                      magnesium in one capsule to support muscl...
                    aigc_keywords:
                      - keyword: magnesium complex capsules
                      - keyword: Toplux magnesium supplement
                      - keyword: 8 forms of magnesium
                      - keyword: magnesium supplement for sleep
                      - keyword: magnesium for bone health
                      - keyword: vegan magnesium capsules
                      - keyword: GMO-free magnesium supplement
                  is_available: true
                region: US
        '404':
          description: Unknown product id
components:
  schemas:
    ShopProductResponse:
      properties:
        product:
          $ref: '#/components/schemas/ShopProductDetail'
        region:
          default: US
          title: Region
          type: string
      required:
        - product
      title: ShopProductResponse
      type: object
    ShopProductDetail:
      properties:
        product_id:
          title: Product Id
          type: string
        title:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Title
        url:
          title: Url
          type: string
        description:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Description
        description_images:
          items:
            type: string
          title: Description Images
          type: array
        images:
          items:
            type: string
          title: Images
          type: array
        price:
          $ref: '#/components/schemas/ShopPrice'
        rating:
          anyOf:
            - type: number
            - type: 'null'
          default: null
          title: Rating
        review_count:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Review Count
        sold_count:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Sold Count
        categories:
          items:
            $ref: '#/components/schemas/ShopCategory'
          title: Categories
          type: array
        sale_properties:
          additionalProperties:
            type: array
            items:
              type: string
          title: Sale Properties
          type: object
        attributes:
          additionalProperties:
            type: string
          title: Attributes
          type: object
        skus:
          items:
            $ref: '#/components/schemas/ShopSku'
          title: Skus
          type: array
        reviews:
          items:
            $ref: '#/components/schemas/ShopReview'
          title: Reviews
          type: array
        rating_breakdown:
          additionalProperties:
            type: integer
          title: Rating Breakdown
          type: object
        shop:
          anyOf:
            - $ref: '#/components/schemas/ShopStore'
            - type: 'null'
          default: null
        seller_business_name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Seller Business Name
        seller_business_address:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Seller Business Address
        ai_summary:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          default: null
          title: Ai Summary
        is_available:
          default: true
          title: Is Available
          type: boolean
      required:
        - product_id
        - url
      title: ShopProductDetail
      type: object
    ShopPrice:
      properties:
        amount:
          anyOf:
            - type: number
            - type: 'null'
          default: null
          title: Amount
        original:
          anyOf:
            - type: number
            - type: 'null'
          default: null
          title: Original
        discount:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Discount
        currency:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Currency
        symbol:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Symbol
      title: ShopPrice
      type: object
    ShopCategory:
      properties:
        id:
          title: Id
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Name
        slug:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Slug
        level:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Level
        is_leaf:
          anyOf:
            - type: boolean
            - type: 'null'
          default: null
          title: Is Leaf
        parent_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Parent Id
        image:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Image
        url:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Url
      required:
        - id
      title: ShopCategory
      type: object
    ShopSku:
      properties:
        sku_id:
          title: Sku Id
          type: string
        properties:
          type: object
          additionalProperties:
            type: string
          title: Properties
        price:
          $ref: '#/components/schemas/ShopPrice'
        available_quantity:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Available Quantity
        in_stock:
          default: false
          title: In Stock
          type: boolean
        image:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Image
      required:
        - sku_id
      title: ShopSku
      type: object
    ShopReview:
      properties:
        review_id:
          title: Review Id
          type: string
        rating:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Rating
        text:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Text
        reviewer_name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Reviewer Name
        created_utc:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Created Utc
        is_verified_purchase:
          default: false
          title: Is Verified Purchase
          type: boolean
        is_incentivized:
          default: false
          title: Is Incentivized
          type: boolean
        sku:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Sku
        images:
          items:
            type: string
          title: Images
          type: array
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Created At
        country:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Country
      required:
        - review_id
      title: ShopReview
      type: object
    ShopStore:
      properties:
        id:
          title: Id
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Name
        logo:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Logo
        url:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Url
        rating:
          anyOf:
            - type: number
            - type: 'null'
          default: null
          title: Rating
        sold_count:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Sold Count
        product_count:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Product Count
        review_count:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Review Count
        followers_count:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Followers Count
        video_count:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Video Count
      required:
        - id
      title: ShopStore
      type: object
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````