---
title: "Scrape one 1688.com offer's full detail"
method: POST
path: "/marketplace/1688-product"
tags: ["Plugins"]
---

# Scrape one 1688.com offer's full detail

`POST /marketplace/1688-product`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/marketplace/1688-product`
- Auth: API key in header `x-scrapeunblocker-key`

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`.

## Query parameters

- `offer_id` string, nullable: Numeric 1688 offer id, e.g. '735353578254' (the number in detail.1688.com/offer/<id>.html).
- `url` string, nullable: 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.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'DE', 'SG'). Leave blank to let the API pick.

## Response `200`

JSON with the full offer record (`product`).

- unknown

## Other responses

- `400`: Invalid or missing offer_id/url.
- `404`: No such offer on 1688 (unknown id or removed).
- `422`: Validation Error
- `502`: Blocked by 1688 on every attempt, no offer data returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)