1688 Supplier Products
Use the 1688 Supplier Products API for ecommerce API integration. Review request parameters, response fields, and runnable examples.
/v1 /alibaba /1688 /suppliers /productsAPI data samples
Inspect the request body and complete response shape used by this endpoint.
{
"supplierId": "b2b-2189087086"
}{
"request_id": "5d2c1b0e-7c1f-4a52-9a54-0d6f3a1b8e24",
"data": {
"products": [
{
"product_id": "757884267242",
"title": "定制加工来图打样贴牌印logo蜜桃瑜伽裤女跑步健身运动紧身裤",
"price": 16.8,
"currency": "CNY",
"sold_count": null,
"shop_name": null,
"repurchase_rate": null,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01KUctsJ22DReO41ZIG_!!2189087086-0-cib.jpg",
"product_url": "https://m.1688.com/offer/757884267242.html"
},
{
"product_id": "757828574587",
"title": "聚衣堂定制加工来图打样贴牌logo瑜伽服外套健身上衣",
"price": 29,
"currency": "CNY",
"sold_count": null,
"shop_name": null,
"repurchase_rate": null,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lMZjgd22DReNrtWG6_!!2189087086-0-cib.jpg",
"product_url": "https://m.1688.com/offer/757828574587.html"
}
],
"page": 1,
"total": 436
}
}Availability: Available
This endpoint is active in the v1 gateway, OpenAPI, and subscription catalog. A successful call consumes 2 billing units.
POST /v1/alibaba/1688/suppliers/products
The request and response fields below match the current public contract.
MCP
| Item | Value |
|---|---|
| MCP Code | alibaba_1688_suppliers_products |
Quick call
First create an API key, then store it in a server-side environment variable:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/alibaba/1688/suppliers/products \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"supplierId": "b2b-2189087086"
}'Integrate with an AI CLI
Copy for your AI CLI
Paste this task into Codex, Claude Code, Gemini CLI, or another coding agent.
Integrate the "1688 Supplier Products" endpoint from Ecommerce Data API into the current repository. Make the changes directly instead of only returning sample code.
API documentation: https://ecommercedataapi.com/en/docs/alibaba/1688/supplier-products
Endpoint: POST https://ecommercedataapi.com/v1/alibaba/1688/suppliers/products
API key environment variable: ECOMMERCE_DATA_API_KEY
Example request:
{
"supplierId": "b2b-2189087086"
}
Requirements:
1. Read the API documentation first, then inspect the repository's language, framework, HTTP client, directory structure, and environment-variable conventions.
2. Reuse the existing API client and error-handling patterns. If none exist, add the smallest reusable Ecommerce Data API client and an endpoint-specific wrapper.
3. Read the key from the server-side ECOMMERCE_DATA_API_KEY environment variable and send Content-Type: application/json plus the X-API-Key header. Never write a real key into source code, browser code, logs, test snapshots, or Git.
4. If the environment variable is missing, tell me to configure ECOMMERCE_DATA_API_KEY myself. Do not request, print, or invent the real key, and continue implementing code and tests that do not require a live request.
5. Implement request and response types from the documentation. Handle non-2xx responses, request_id, error.code, error.message, and 429 rate limits.
6. Add a minimal usage example or test that follows the repository's conventions. Run one minimal live request only when the key is already configured and external requests are allowed; otherwise use mocks or static validation.
7. Run the relevant formatter, type checker, and tests. Report changed files, usage, verification results, and any environment variable I still need to configure.Open this request in Postman
Download the preconfigured collection for this endpoint, then import it into Postman.
Node.js example
const response = await fetch(
'https://ecommercedataapi.com/v1/alibaba/1688/suppliers/products',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
supplierId: 'b2b-2189087086',
}),
}
);
const result = await response.json();
if (!response.ok) {
throw new Error(`${result.error?.code}: ${result.error?.message}`);
}
console.log(result.data);Python example
import os
import requests
response = requests.post(
"https://ecommercedataapi.com/v1/alibaba/1688/suppliers/products",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"supplierId": "b2b-2189087086",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])Request body
Send the fields below directly in the JSON body without an extra wrapper. Undefined fields are rejected.
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
supplierId | String | Yes | Supplier ID, usually starting with b2b-. Take it from supplier_id in 1688 Factory Search or 1688 Product Details. The all-digit seller_id is not accepted. | b2b-2189087086 |
page | Integer | No | Page number, starting at 1. Each page holds 20 products. Pages can repeat a few products, so deduplicate by product_id. | 1 |
Response structure
| Field | Type | Description |
|---|---|---|
request_id | String | Unique identifier for this request. |
data | Object | Endpoint business data. |
The fields below are inside data. For array endpoints they describe one array item; for paginated endpoints they describe one record in items[].
Response fields
| Field | Type | Description | Example |
|---|---|---|---|
products.product_id | String | 1688 listing ID; pass it to 1688 Product Details. | 757884267242 |
products.title | String | Listing title, in Chinese. | - |
products.price | Number | Supplier price in CNY. Listings with tiered or per-SKU prices show one of them; call Product Details for the tiers. | 16.8 |
products.currency | String | Currency code, always CNY. | CNY |
products.sold_count | Integer | Always null in this endpoint; call 1688 Product Details for units sold. | - |
products.shop_name | String | Always null in this endpoint. | - |
products.repurchase_rate | String | Always null in this endpoint; the supplier's rate is in 1688 Factory Profile. | - |
products.image_url | String | Main image URL. | - |
products.product_url | String | Listing page URL on 1688. | - |
page | Integer | Page number returned. | 1 |
total | Integer | Number of products the supplier lists. | 436 |
Response example
{
"request_id": "5d2c1b0e-7c1f-4a52-9a54-0d6f3a1b8e24",
"data": {
"products": [
{
"product_id": "757884267242",
"title": "定制加工来图打样贴牌印logo蜜桃瑜伽裤女跑步健身运动紧身裤",
"price": 16.8,
"currency": "CNY",
"sold_count": null,
"shop_name": null,
"repurchase_rate": null,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01KUctsJ22DReO41ZIG_!!2189087086-0-cib.jpg",
"product_url": "https://m.1688.com/offer/757884267242.html"
},
{
"product_id": "757828574587",
"title": "聚衣堂定制加工来图打样贴牌logo瑜伽服外套健身上衣",
"price": 29,
"currency": "CNY",
"sold_count": null,
"shop_name": null,
"repurchase_rate": null,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lMZjgd22DReNrtWG6_!!2189087086-0-cib.jpg",
"product_url": "https://m.1688.com/offer/757828574587.html"
}
],
"page": 1,
"total": 436
}
}See Errors and rate limits for error payloads, request tracing, and rate-limit headers.