1688 Search Factory
Find factories by keyword for procurement research. A keyword is required. You can choose a page (starting at 1; default 1), a requested page size (default 20), and either default sorting or repurchase-rate sorting using sort values default and repurchase_rate. The number of results returned may differ from the requested page size. The response includes search data, a response code, a message, and a record time; the message and record time may be null. The search data structure is not specified, so individual factory details and total counts are not guaranteed.
Pricing
| Condition | Charge |
|---|---|
| Each call | 17.46 credits/call |
Each call has a fixed charge of 17.46 credits.
The page number, requested page size, and sort order do not affect the fixed charge per call. The actual number of results may differ from the requested page size and does not affect the charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | 页码,从1开始。 | 1 |
sort | enum (default | repurchase_rate) | No | 1688 FactorySort 请求值 | default |
keyword | string | Yes | 工厂搜索关键词。 | — |
pageSize | integer | No | 每页请求的商品数量。返回数量可能有所不同。 | 20 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_ali1688_search_factory' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "凯石体育 健身器材",
"page": 1,
"pageSize": 10
}
}'{
"code": 0,
"data": {
"items": [
{
"company_name": "义乌市弘帝服装有限公司",
"factory_level": "无牌工厂",
"factory_url": "https://sale.1688.com/factory/card.html?__existtitle__=1&__removesafearea__=1&memberId=b2b-3848795448f464b",
"invoice_available": false,
"is_factory": true,
"location": {
"city": null
}
}
],
"keywords": "凯石体育 健身器材",
"page": 1,
"page_size": 20,
"sort": "default",
"total_count": 1000
},
"message": null,
"recordTime": "2026-11-10T11:06:51.835273657",
"requestParams": {
"body": null,
"query": {
"keyword": "凯石体育 健身器材",
"page": "1",
"pageSize": "10",
"sort": "default"
}
}
}This example shows part of the response. Copied content is valid JSON.

