AliExpress Search Products

17.46 credits/call
ae_aliexpress_search_products

Search marketplace products for product discovery, catalog research, and category analysis. All inputs are optional: provide search terms (q), category or brand IDs (catId, brandId), location (loc), product attributes (attr), or result feature switches (switches). page is a string containing a page number starting at 1. sort supports default ordering (default), sales high to low (salesDesc), price low to high (priceAsc), and price high to low (priceDesc); the default is default. Numeric startPrice and endPrice set inclusive price limits. locale, region, and currency control the response locale, market region, and price currency. The response includes the search payload (data), a response code (code), a message (message), and a recorded time (recordTime). Product fields and pagination details within data are not specified, so use the actual returned content and response message to interpret results.

Productivity
17.46 credits/call

Pricing

17.46 credits/call
ConditionCharge
Each call17.46 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
qstringNo商品搜索查询词。—
locstringNo商品搜索结果的位置筛选条件。—
attrstringNo搜索结果的商品属性筛选条件。—
pagestringNo分页使用的从 1 开始的页码。—
sortenum (default | salesDesc | priceAsc | priceDesc)NoAliExpress 商品搜索排序方式default
catIdstringNo用于筛选商品搜索结果的类别 ID。—
localestringNo用于 AliExpress 响应的语言环境。—
regionstringNoAliExpress 市场地区。—
brandIdstringNo用于筛选商品搜索结果的品牌 ID。—
currencystringNo用于商品价格的货币代码。—
endPricenumberNo商品最高价格筛选(包含边界值)。—
switchesstringNo用于选择可选结果特性的搜索开关。—
startPricenumberNo商品最低价格筛选(包含边界值)。—

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_aliexpress_search_products' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "currency": "USD",
    "endPrice": 17,
    "locale": "en_US",
    "page": "1",
    "q": "acrylic nail polish rack wall mounted",
    "region": "US",
    "sort": "salesDesc",
    "startPrice": 9
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "result": {
      "base": {
        "pageSize": "20",
        "q": "acrylic nail polish rack wall mounted",
        "sortValues": [
          "default"
        ],
        "switchesList": [],
        "totalResults": "828"
      },
      "resultList": [
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.9,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S0a6804d21ac44b1ca487fca8dec6cdb8H.jpg",
            "itemId": "3256807801535351",
            "itemUrl": "//www.aliexpress.com/item/3256807801535351.html",
            "title": "Stainless Steel Bathroom Shelf Shampoo Makeup Shower Storage Shelf Bathroom Wall Mount Corner Organizer Rack",
            "type": "natural"
          },
          "sellingPoints": null
        }
      ]
    }
  },
  "message": null,
  "recordTime": "2026-11-06T15:15:31.603772089",
  "requestParams": {
    "body": null,
    "query": {
      "currency": "USD",
      "endPrice": "17",
      "locale": "en_US",
      "page": "1",
      "q": "acrylic nail polish rack wall mounted",
      "region": "US"
    }
  }
}

This example shows part of the response. Copied content is valid JSON.