1688 Factory Profile
Use the 1688 Factory Profile API for ecommerce API integration. Review request parameters, response fields, and runnable examples.
/v1 /alibaba /1688 /factories /detailAPI data samples
Inspect the request body and complete response shape used by this endpoint.
{
"supplierId": "b2b-2189087086"
}{
"request_id": "5d2c1b0e-7c1f-4a52-9a54-0d6f3a1b8e23",
"data": {
"supplier_id": "b2b-2189087086",
"company_name": "浦江福衣特服饰有限公司",
"shop_name": "福衣特旗舰店",
"description": "福衣特是全球规模领先的瑜伽服供应商。经过10余年发展,公司已演变成一家集研发、纺织、生产、销售为一体的链主型企业。",
"main_products": [
"瑜伽服",
"运动内衣",
"运动紧身裤"
],
"processing_methods": [
"来样加工",
"来图加工",
"包工包料",
"清加工"
],
"registered_on": "2021-02-08",
"employees": "201~300人",
"annual_turnover": "2000万以上",
"factory_area_sqm": 3000,
"equipment_count": 50,
"custom_min_order": "100件",
"oem_min_order": "100件",
"repurchase_rate": "72%",
"response_rate": "74%",
"on_time_rate": "97%",
"interested_buyers": 524,
"exports": false,
"vat_invoice": "有",
"invoice_tax_rate": "13%",
"logo_url": "https://cbu01.alicdn.com/img/ibank/O1CN015ZZ1tF1Bs2gcTkm6K_!!0-0-cib.jpg"
}
}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/factories/detail
The request and response fields below match the current public contract.
MCP
| Item | Value |
|---|---|
| MCP Code | alibaba_1688_factories_detail |
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/factories/detail \
--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 Factory Profile" 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/factory-profile
Endpoint: POST https://ecommercedataapi.com/v1/alibaba/1688/factories/detail
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/factories/detail',
{
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/factories/detail",
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 |
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 |
|---|---|---|---|
supplier_id | String | Supplier ID. | b2b-2189087086 |
company_name | String | Registered company name, in Chinese. | 浦江福衣特服饰有限公司 |
shop_name | String | Shop name on 1688. | 福衣特旗舰店 |
description | String | The factory's own introduction, in Chinese. | - |
main_products | Array | Products the factory mainly makes. | - |
processing_methods | Array | Manufacturing services offered, in Chinese, such as 来样加工 (make to sample) or 包工包料 (labour and materials). | - |
registered_on | String | Date the factory profile was registered, YYYY-MM-DD. | 2021-02-08 |
employees | String | Headcount range as 1688 shows it. | 201~300人 |
annual_turnover | String | Annual turnover range in CNY as 1688 shows it (万 = 10,000). | 2000万以上 |
factory_area_sqm | Number | Factory floor area in square metres. | 3000 |
equipment_count | Integer | Number of production machines. | 50 |
custom_min_order | String | Minimum order for customised goods, with its unit. | 100件 |
oem_min_order | String | Minimum order for OEM or private-label production, with its unit. | 100件 |
repurchase_rate | String | Share of buyers who ordered again, as a percentage string. | 72% |
response_rate | String | Share of buyer enquiries the factory answers, as a percentage string. | 74% |
on_time_rate | String | Share of orders shipped on time, as a percentage string. Null when 1688 has no figure. | 97% |
interested_buyers | Integer | Buyers who recently showed interest in ordering. | 524 |
exports | Boolean | Whether the factory states that it does export business. | false |
vat_invoice | String | Whether VAT invoices are issued: 有 (yes) or 无 (no). | 有 |
invoice_tax_rate | String | Tax rate on invoices. Null when not stated. | 13% |
logo_url | String | Factory logo URL. Null when there is none. | - |
Response example
{
"request_id": "5d2c1b0e-7c1f-4a52-9a54-0d6f3a1b8e23",
"data": {
"supplier_id": "b2b-2189087086",
"company_name": "浦江福衣特服饰有限公司",
"shop_name": "福衣特旗舰店",
"description": "福衣特是全球规模领先的瑜伽服供应商。经过10余年发展,公司已演变成一家集研发、纺织、生产、销售为一体的链主型企业。",
"main_products": ["瑜伽服", "运动内衣", "运动紧身裤"],
"processing_methods": ["来样加工", "来图加工", "包工包料", "清加工"],
"registered_on": "2021-02-08",
"employees": "201~300人",
"annual_turnover": "2000万以上",
"factory_area_sqm": 3000,
"equipment_count": 50,
"custom_min_order": "100件",
"oem_min_order": "100件",
"repurchase_rate": "72%",
"response_rate": "74%",
"on_time_rate": "97%",
"interested_buyers": 524,
"exports": false,
"vat_invoice": "有",
"invoice_tax_rate": "13%",
"logo_url": "https://cbu01.alicdn.com/img/ibank/O1CN015ZZ1tF1Bs2gcTkm6K_!!0-0-cib.jpg"
}
}See Errors and rate limits for error payloads, request tracing, and rate-limit headers.