> ## 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 1688.com offer's full detail

> Fetches one 1688.com offer (by `offer_id` or `url`) and returns it as JSON: `title`, `status`, `brand`, `category`, prices in yuan (`currency` CNY: `priceText`, `priceMin`/`priceMax`), `pricing` (`tiers` when every SKU is priced by the quantity ladder `priceTiers`, `sku` when each SKU carries its own `price`), `originalPriceTiers` (before a promotion), `unit`, `moq` (minimum order), `available` (stock), `sold` + `soldText` + `soldPeriod`, `variantOptions` (option names and values with images) and `variants` (every SKU with `skuId`, `options`, `price`, `available`), `attributes`, `images`, `video`, `descriptionUrl`, `shipping` (`from`, `dispatch` promise, `unitWeightKg`, `freeShipping`), `services` (guarantees), `labels`, `rating` (`goodRatePercent`, `score`, `reviewCount`, `reviewsWithPhotos`, review `tags`), `favorites` and the `supplier` (`name`, `loginId`, `memberId`, `userId`, `shopUrl`, `serviceScore`, `repeatPurchaseRate3m`, `factory`, `tpMember`, `location`). Text is returned in Chinese as 1688 publishes it. Companion to `/marketplace/1688-search`.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/1688-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/1688-product:
    post:
      tags:
        - Plugins
      summary: Scrape one 1688.com offer's full detail
      description: >-
        Fetches one 1688.com offer (by `offer_id` or `url`) and returns it as
        JSON: `title`, `status`, `brand`, `category`, prices in yuan (`currency`
        CNY: `priceText`, `priceMin`/`priceMax`), `pricing` (`tiers` when every
        SKU is priced by the quantity ladder `priceTiers`, `sku` when each SKU
        carries its own `price`), `originalPriceTiers` (before a promotion),
        `unit`, `moq` (minimum order), `available` (stock), `sold` + `soldText`
        + `soldPeriod`, `variantOptions` (option names and values with images)
        and `variants` (every SKU with `skuId`, `options`, `price`,
        `available`), `attributes`, `images`, `video`, `descriptionUrl`,
        `shipping` (`from`, `dispatch` promise, `unitWeightKg`, `freeShipping`),
        `services` (guarantees), `labels`, `rating` (`goodRatePercent`, `score`,
        `reviewCount`, `reviewsWithPhotos`, review `tags`), `favorites` and the
        `supplier` (`name`, `loginId`, `memberId`, `userId`, `shopUrl`,
        `serviceScore`, `repeatPurchaseRate3m`, `factory`, `tpMember`,
        `location`). Text is returned in Chinese as 1688 publishes it. Companion
        to `/marketplace/1688-search`.
      operationId: product_1688_marketplace_1688_product_post
      parameters:
        - name: offer_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Numeric 1688 offer id, e.g. '735353578254' (the number in
              detail.1688.com/offer/<id>.html).
            title: Offer Id
          description: >-
            Numeric 1688 offer id, e.g. '735353578254' (the number in
            detail.1688.com/offer/<id>.html).
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              1688 offer link, e.g.
              'https://detail.1688.com/offer/735353578254.html' (mobile
              m.1688.com and offerId= links work too). Either offer_id or url is
              required.
            title: Url
          description: >-
            1688 offer link, e.g.
            'https://detail.1688.com/offer/735353578254.html' (mobile m.1688.com
            and offerId= links work too). Either offer_id or url is required.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'DE', 'SG').
              Leave blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'DE', 'SG').
            Leave blank to let the API pick.
      responses:
        '200':
          description: JSON with the full offer record (`product`).
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid or missing offer_id/url.
        '404':
          description: No such offer on 1688 (unknown id or removed).
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by 1688 on every attempt, no offer data returned, or the
            call did not finish in time.
      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.