1688 Product Search

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

Productivity
2.62 credits/call

Pricing

2.62 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
pageintegerNoWhich page of data to query, defaults to page 1.1
rightsstringNoFilter 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_idstringNoQuery based on a category (not limited to leaf categories); if specified, search within that category.""
sku_count_maxintegerNoFilter products with SKU count less than or equal to this value.0
sku_count_minintegerNoFilter products with SKU count greater than or equal to this value.0
supplier_typeintegerNoFilter by supplier type, single choice. 1: Powerful merchant, 2: Super factory.0
stock_count_maxintegerNoFilter products with stock count less than or equal to this value.0
stock_count_minintegerNoFilter products with stock count greater than or equal to this value.0
service_score_maxnumberNoFilter products with overall service score less than or equal to this value.0
service_score_minnumberNoFilter products with overall service score greater than or equal to this value.0
repurchase_rate_maxnumberNoFilter products with repurchase rate less than or equal to this value.0
repurchase_rate_minnumberNoFilter products with repurchase rate greater than or equal to this value.0
supplier_member_typeintegerNoFilter by supplier member type, single choice. 1: Deep certified, 2: Non-deep certified.0
online_date_range_maxstringNoFilter products by listing end date, date format yyyy-MM-dd.""
online_date_range_minstringNoFilter products by listing start date, date format yyyy-MM-dd.""
recent_30_day_sale_maxintegerNoFilter products with sales quantity in the last 30 days less than or equal to this value.0
recent_30_day_sale_minintegerNoFilter products with sales quantity in the last 30 days greater than or equal to this value.0
cumulative_sale_count_maxintegerNoFilter products with cumulative sales volume less than or equal to this value.0
cumulative_sale_count_minintegerNoFilter products with cumulative sales volume greater than or equal to this value.0
dropshipping_price_range_maxnumberNoFilter products with selling price less than or equal to this value.0
dropshipping_price_range_minnumberNoFilter products with selling price greater than or equal to this value.0

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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

Finding 1688 Dropshipping Suppliers with AI AgentsFor small dropshippers: use one AI agent to pull 1688 suppliers by product name, check wholesale prices and MOQs, filter for dropship-friendly sources, add similar-item backups, and output a supplier comparison table.Cross-Platform Product Price Comparison with One AI AgentLet one AI agent compare the same product across 1688, Taobao, JD, Temu, Amazon and Shopee in a single instruction: it pulls price, sales and MOQ together, aligns the fields, flags the lowest price and best value, and outputs a cross-platform comparison table. No per-API integration.The AI Agent Tool Stack for Cross-Border E-CommerceOne agent, one key, from sourcing to intelligence to creative to ads. See how a cross-border e-commerce team runs product sourcing, competitor research, image generation and SEO through a single AI agent stack.Niche Category Best-Seller Scanning across MarketplacesPoint one AI agent at a niche category and have it scan best sellers across Amazon, 1688, Temu and Shopee by category, align titles, prices and sales, merge and rank them, and output one cross-platform best-seller board. No per-platform manual digging.What AI Agents Can Do With Tools: 15 Real Use CasesAn AI agent on its own can only talk. Connect it to tools and it can research, source products, generate images and video, pull live financial data, and more. Here are 15 real things agents do with tools.1688 Product Sourcing Workflow for AI AgentsLet one AI agent source products on 1688 end to end: search by keyword or image, find similar listings to compare prices, check SKU variations, verify categories, and output a candidate comparison table. No login, no per-API integration.