# Detail 1688 — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Retrieve comprehensive product data from 1688.com product pages, including titles, images, pricing, SKU variants, attributes, seller details, packing specifications, and drop-shipping information — no login required.

**Category:** Marketplaces | **Website:** [detail.1688.com/](https://detail.1688.com/) | **Docs:** [parse.bot/marketplace/1b01e91b-99c9-4dca-81a5-56b81d9112c0/detail-1688-com-api](https://parse.bot/marketplace/1b01e91b-99c9-4dca-81a5-56b81d9112c0/detail-1688-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_drop_shipping_info

Returns drop shipping and distribution channel information including supported platforms (Taobao, Douyin, Amazon, Shopee, etc.) and consignment terms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_drop_shipping_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_product_attributes

Returns all product attributes and specifications (material, style, brand, origin, etc.) as an array of name-value pairs with field IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_product_attributes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_product_color_codes

Extracts color variant names and associated image URLs from the product's SKU color property group. Returns an empty array when the product has no color variants.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_product_color_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_product_detail_images

Extracts marketing and description images from the product detail/description section. Fetches the detail content URL and parses image URLs from it. Returns an empty items array when no detail content is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_product_detail_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_product_details

Fetches comprehensive product details for a 1688.com listing including title, images, seller summary, price range, sales count, and product attributes. Single-page response per offer ID. Rate-limited: one request per IP before antibot triggers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL containing the offer ID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_product_packing_info

Returns packing and weight information per SKU when available. Many listings do not provide packing info, in which case an empty items array is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_product_packing_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_product_pricing

Returns product pricing details: overall min/max price, tier pricing model with quantity breaks, minimum order quantity, and per-SKU pricing from the SKU map.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_product_pricing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_product_variants

Returns SKU variant data for a product: property groups (color, size), a map of individual SKUs with per-variant pricing and stock, and optional SKU features metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_product_variants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```

### get_seller_info

Returns supplier/seller information including company name, login ID, member ID, shop URL, user ID, and seller identity badges.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-detail-1688-com-api-1b01e91b/get_seller_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>"}'
```