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

# Scrape one TikTok Shop product

> Fetches a public TikTok Shop (US) product page by `url` or `product_id` and returns it as JSON: `productId`, `url`, `title`, `description` (plus `descriptionImages`), `status`, `available`, `brand`, `price` (current, original, discountPercent, currency, display strings, min/max for a price range), `soldCount`, `rating`, `reviewCount`, `ratingDistribution`, `categories`, `images`, `options` and `variants` (per-SKU price, stock and availability), `specifications`, `shipping` (fee, free, delivery days and estimate), promotion `labels`, `seller` (id, name, store URL, rating, followers, sold count, product / video / review counts, service scores, business name and address) and the top `reviews` the page shows (rating, text, date, variant, images). One billed request. No login or cookies; a product that does not exist or is not sold in the US returns 404.



## OpenAPI

````yaml /api-reference/openapi.json post /social/tiktok-shop-product
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /social/tiktok-shop-product:
    post:
      tags:
        - Plugins
      summary: Scrape one TikTok Shop product
      description: >-
        Fetches a public TikTok Shop (US) product page by `url` or `product_id`
        and returns it as JSON: `productId`, `url`, `title`, `description` (plus
        `descriptionImages`), `status`, `available`, `brand`, `price` (current,
        original, discountPercent, currency, display strings, min/max for a
        price range), `soldCount`, `rating`, `reviewCount`,
        `ratingDistribution`, `categories`, `images`, `options` and `variants`
        (per-SKU price, stock and availability), `specifications`, `shipping`
        (fee, free, delivery days and estimate), promotion `labels`, `seller`
        (id, name, store URL, rating, followers, sold count, product / video /
        review counts, service scores, business name and address) and the top
        `reviews` the page shows (rating, text, date, variant, images). One
        billed request. No login or cookies; a product that does not exist or is
        not sold in the US returns 404.
      operationId: tiktok_shop_product_social_tiktok_shop_product_post
      parameters:
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              A TikTok Shop product URL
              ('https://www.tiktok.com/shop/pdp/goli-ashwagandha/1729527313880355335',
              'https://shop.tiktok.com/us/pdp/1729527313880355335', a
              /view/product/ link) or a bare product id. Either this or
              `product_id`.
            title: Url
          description: >-
            A TikTok Shop product URL
            ('https://www.tiktok.com/shop/pdp/goli-ashwagandha/1729527313880355335',
            'https://shop.tiktok.com/us/pdp/1729527313880355335', a
            /view/product/ link) or a bare product id. Either this or
            `product_id`.
        - name: product_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: The numeric product id (e.g. '1729527313880355335').
            title: Product Id
          description: The numeric product id (e.g. '1729527313880355335').
      responses:
        '200':
          description: JSON product object.
          content:
            application/json:
              schema: {}
        '400':
          description: Missing or malformed url / product_id, or a non-US market URL.
        '404':
          description: No such product in the US TikTok Shop (or it was removed).
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked by TikTok on every exit tried - retry.
        '504':
          description: Fetch timed out.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

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