# alibaba1688_list_offer_variants (https://sellersheetai.com/docs/mcp-api/tools/alibaba1688_list_offer_variants)

> Read every variant of one 1688 product and store them for the account, so each can be paired; then call alibaba1688_pair_sku with a variant's item_id.

Access: **WRITE** · toolset alibaba1688 · family null

## Call it

MCP tool call:

```json
{
  "name": "alibaba1688_list_offer_variants",
  "arguments": {
    "account": "<account>",
    "offer": "<offer>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/alibaba1688_list_offer_variants \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"<account>","offer":"<offer>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `account` | string | yes | the 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim. |
| `offer` | string | yes | the 1688 product link `https://detail.1688.com/offer/<id>.html`, or the offer id alone (digits). A short link is refused. |

## Result

- `data.offer_id / data.subject` — the product read.
- `data.items[]` — one per variant, and one more per further local SKU it is paired with — item_id, spec_id, attributes [{name, value}], price_yuan, unit, min_order_qty, supplier_login_id, state, sku (the local SKU of that row, or null).

## Gotchas

- 1688 serves a product's detail only for a supplier the account has bought from, and meters it on a paid quota: a refusal carries 1688's own sentence; relay it.
- A variant stored before that 1688 no longer lists becomes state gone; a paired one keeps its pairing and cannot be ordered until paired again.