1688 Search Factory

17.46 credits/call
ae_ali1688_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.

Productivity
17.46 credits/call

Pricing

17.46 credits/call
ConditionCharge
Each call17.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.

ParameterTypeRequiredDescriptionDefault
pageintegerNo页码,从1开始。1
sortenum (default | repurchase_rate)No1688 FactorySort 请求值default
keywordstringYes工厂搜索关键词。—
pageSizeintegerNo每页请求的商品数量。返回数量可能有所不同。20

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.