> ## 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 Taobao / Tmall item

> Returns one Taobao or Tmall item (by `item_id` or `url`) as JSON: `itemId`, `url`, `platform` (taobao / tmall), `title` (`titleTruncated` when Taobao shortens it, as it does for Tmall items), `price`, `originalPrice` and `priceMax` (for a price range) in yuan with `currency` CNY, `image`, `location` (ships from), `categoryId`, `rootCategoryId`, `categoryPath`, `freeShipping`, `paymentMethods`, `sellableLanguages`, `rating` (positive / neutral / negative split and counts; Taobao items only, Tmall does not publish it), `latestReview` (`rating`, `content`, `date`, `variant`, `hasMedia`, `followUps`; no reviewer identity, so no review photo or video URLs) and `shop` (`shopId`, `name`, `url`, `logo`, `sellerType` B = Tmall / C = Taobao, `creditLevel`, `openedAt`, `itemCount`, `scores` for description, service and delivery). This is what Taobao shows signed-out visitors: variants (SKUs), stock and monthly sales need a Taobao login and are not included. Companion to `/marketplace/taobao-search`. One unit per call.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/taobao-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:
  /marketplace/taobao-product:
    post:
      tags:
        - Plugins
      summary: Scrape one Taobao / Tmall item
      description: >-
        Returns one Taobao or Tmall item (by `item_id` or `url`) as JSON:
        `itemId`, `url`, `platform` (taobao / tmall), `title` (`titleTruncated`
        when Taobao shortens it, as it does for Tmall items), `price`,
        `originalPrice` and `priceMax` (for a price range) in yuan with
        `currency` CNY, `image`, `location` (ships from), `categoryId`,
        `rootCategoryId`, `categoryPath`, `freeShipping`, `paymentMethods`,
        `sellableLanguages`, `rating` (positive / neutral / negative split and
        counts; Taobao items only, Tmall does not publish it), `latestReview`
        (`rating`, `content`, `date`, `variant`, `hasMedia`, `followUps`; no
        reviewer identity, so no review photo or video URLs) and `shop`
        (`shopId`, `name`, `url`, `logo`, `sellerType` B = Tmall / C = Taobao,
        `creditLevel`, `openedAt`, `itemCount`, `scores` for description,
        service and delivery). This is what Taobao shows signed-out visitors:
        variants (SKUs), stock and monthly sales need a Taobao login and are not
        included. Companion to `/marketplace/taobao-search`. One unit per call.
      operationId: taobao_product_marketplace_taobao_product_post
      parameters:
        - name: item_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Numeric Taobao or Tmall item id, e.g. '765833709683' (the `id` in
              item.taobao.com/item.htm?id=...).
            title: Item Id
          description: >-
            Numeric Taobao or Tmall item id, e.g. '765833709683' (the `id` in
            item.taobao.com/item.htm?id=...).
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Taobao or Tmall item link, e.g.
              'https://item.taobao.com/item.htm?id=765833709683' or
              'https://detail.tmall.com/item.htm?id=1081364414020'
              (world.taobao.com, mobile and overseas item links work too).
              Either item_id or url is required.
            title: Url
          description: >-
            Taobao or Tmall item link, e.g.
            'https://item.taobao.com/item.htm?id=765833709683' or
            'https://detail.tmall.com/item.htm?id=1081364414020'
            (world.taobao.com, mobile and overseas item links work too). Either
            item_id or url is required.
      responses:
        '200':
          description: JSON with `product`.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid or missing item_id / url.
        '404':
          description: >-
            Taobao has no public page for the item (removed, or not shown to
            signed-out visitors); not billed.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Taobao refused every attempt, or no answer in time; not billed.
      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.