> ## 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, real price, SKUs with stock, first reviews with totals, shop stats and TikTok's AI summary.

<Note>
  `skus` carry per-variant `properties`, `price`, `available_quantity` and `in_stock`; `reviews` are the first few with `reviews_total` and `rating_breakdown` — page through [Shop Product Reviews](/api-reference/endpoint/tiktok/shop-reviews); `shop` carries the store's sold/follower/review counts. Where the storefront masks a promoted price the real price is filled from the detail API. Unknown ids return `404`. Works in `US`, `GB` and `ID`.
</Note>

<Note>
  **Markets** — `region=US` (default) serves everything; `GB` and `ID` (Tokopedia) serve categories, category products and product detail in GBP/IDR. SG, MY, PH, TH, VN, MX, BR and JP sit behind a puzzle our exits do not clear and return `400`.
</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, the
        first reviews with the total and rating breakdown, shop stats, seller
        business identity and TikTok's AI summary. Where the storefront masks a
        promoted price, the real price is filled from the detail API (US).
      operationId: getTikTokShopProduct
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            Numeric TikTok Shop product id (from ranking, category, search or
            store results).
        - name: region
          in: query
          schema:
            type: string
            default: US
            enum:
              - US
              - GB
              - ID
          description: >-
            Market. US serves everything; GB and ID serve categories, category
            products and product detail (their JSON API paths do not exist).
            Other storefronts return 400.
      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: 17.97
                    original: 49.97
                    discount: 64%
                    currency: USD
                    symbol: $
                  rating: 4.6
                  review_count: 157996
                  sold_count: 2024716
                  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: 17.97
                        original: 49.97
                        discount: 64%
                        currency: USD
                        symbol: $
                      available_quantity: 8409
                      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
                  reviews_total: 157996
                  rating_breakdown:
                    '1': 9879
                    '2': 2693
                    '3': 6568
                    '4': 13699
                    '5': 125157
                  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: 3662243
                    product_count: 22
                    review_count: 269167
                    followers_count: 134997
                    video_count: 1398
                  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
        '400':
          description: Unsupported market or feature for the market
        '404':
          description: Unknown product id
components:
  schemas:
    ShopProductResponse:
      properties:
        product:
          $ref: '#/components/schemas/ShopProductDetail'
        region:
          title: Region
          type: string
      required:
        - product
        - region
      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
        reviews_total:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Reviews Total
        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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.