1688 Product Search
Search 1688 product information to support sourcing and product shortlisting. Narrow results by category, supplier type or certification, benefits, listing dates, and ranges for selling price, SKU count, stock, service score, repurchase rate, recent 30-day sales, and cumulative sales. Category searches can include non-leaf categories. All inputs are optional; page defaults to 1, and listing dates use yyyy-MM-dd. Benefits can be combined using comma-separated codes for 7-day free return, free shipping insurance, and shipping within 48 hours. These options filter products rather than guarantee service. This tool has no keyword-search input, and the provider has not specified a fixed output schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.62 credits/call |
Billed by the number of calls, with a fixed charge of 2.62 credits per call.
Retrieving another page requires a separate call, charged individually. Billing is not based on the number of products returned.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Which page of data to query, defaults to page 1. | 1 |
rights | string | No | Filter by rights/benefits. Multiple choice, comma-separated, e.g. "1,2,3". 1: 7-day free return, 2: free shipping insurance, 3: ship within 48 hours. | "" |
node_id | string | No | Query based on a category (not limited to leaf categories); if specified, search within that category. | "" |
sku_count_max | integer | No | Filter products with SKU count less than or equal to this value. | 0 |
sku_count_min | integer | No | Filter products with SKU count greater than or equal to this value. | 0 |
supplier_type | integer | No | Filter by supplier type, single choice. 1: Powerful merchant, 2: Super factory. | 0 |
stock_count_max | integer | No | Filter products with stock count less than or equal to this value. | 0 |
stock_count_min | integer | No | Filter products with stock count greater than or equal to this value. | 0 |
service_score_max | number | No | Filter products with overall service score less than or equal to this value. | 0 |
service_score_min | number | No | Filter products with overall service score greater than or equal to this value. | 0 |
repurchase_rate_max | number | No | Filter products with repurchase rate less than or equal to this value. | 0 |
repurchase_rate_min | number | No | Filter products with repurchase rate greater than or equal to this value. | 0 |
supplier_member_type | integer | No | Filter by supplier member type, single choice. 1: Deep certified, 2: Non-deep certified. | 0 |
online_date_range_max | string | No | Filter products by listing end date, date format yyyy-MM-dd. | "" |
online_date_range_min | string | No | Filter products by listing start date, date format yyyy-MM-dd. | "" |
recent_30_day_sale_max | integer | No | Filter products with sales quantity in the last 30 days less than or equal to this value. | 0 |
recent_30_day_sale_min | integer | No | Filter products with sales quantity in the last 30 days greater than or equal to this value. | 0 |
cumulative_sale_count_max | integer | No | Filter products with cumulative sales volume less than or equal to this value. | 0 |
cumulative_sale_count_min | integer | No | Filter products with cumulative sales volume greater than or equal to this value. | 0 |
dropshipping_price_range_max | number | No | Filter products with selling price less than or equal to this value. | 0 |
dropshipping_price_range_min | number | No | Filter products with selling price greater than or equal to this value. | 0 |
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_product_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"node_id": "201547901",
"page": 2,
"rights": "2,3"
}
}'{
"data": [
{
"is_drop_shipping": true,
"min_order_quantity": 1,
"offer_identities": [
"诚信通"
],
"online_date": "2025-04-14",
"title": "独立包装白猫眼石女式吊坠耳钉套装金色项链送礼新款",
"url": "https://detail.1688.com/offer/911532680158.html"
}
],
"doc": {
"is_drop_shipping": "Whether one-piece dropshipping is supported (boolean, true means supported).",
"min_order_quantity": "Minimum order quantity (integer, taken from the first purchase_quantity of wholesale_price_range).",
"offer_identities": "Array of offer/product tags (e.g. \"selected\").",
"online_date": "Product listing date (yyyy-MM-dd).",
"title": "Product title.",
"url": "1688 product detail page URL."
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

