Taobao Tmall Search Products With Filters

26.19 credits/call
ae_taobao_tmall_search_products_with_filters

Search Taobao and Tmall products using a required keyword. Optionally choose a page (default 1), restrict results to Tmall (off by default), or set inclusive minimum and maximum prices as strings. Sorting supports sales volume (_sale, default), price high to low (_bid), price low to high (bid), and general sorting (_coefp). Returns search-result data together with a status code, message, and record time. The fields within the result data are not specified; available product information depends on the returned response.

Productivity
26.19 credits/call

Pricing

26.19 credits/call
ConditionCharge
Each call26.19 credits/call

A fixed charge of 26.19 credits applies per call.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNo用于分页的页码。1
sortenum (_sale | _bid | bid | _coefp)No淘宝搜索商品列表排序选项_sale
tmallbooleanNo是否将结果筛选为仅天猫商品。false
keywordstringYes搜索关键词。—
endPricestringNo最高价格筛选(包含)。—
startPricestringNo最低价格筛选(包含)。—

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_taobao_tmall_search_products_with_filters' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "双眼皮贴",
    "page": 1,
    "sort": "bid"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "code": "SUCCESS",
    "extraMap": {
      "MtopCostMillis": 92
    },
    "model": {
      "brandList": [
        {
          "brandId": 708308673,
          "brandName": "健美创研",
          "count": 36
        }
      ],
      "costMillis": 92,
      "extraMap": {
        "Endpoint": "taobao_item",
        "EndpointHost": "[REDACTED]",
        "WorldsearchIP": "[REDACTED]",
        "WorldsearchName": "[REDACTED]",
        "afterSearchCostMillis": 1,
        "sp_status": "OK"
      },
      "itemList": [],
      "page": {
        "nextNo": 2,
        "pageNo": 1,
        "pageSize": 10,
        "prevNo": 1,
        "showBegin": 1,
        "showEnd": 3
      },
      "success": true
    }
  },
  "message": null,
  "recordTime": "2026-11-12T11:44:24.667130544",
  "requestParams": {
    "body": null,
    "query": {
      "keyword": "双眼皮贴",
      "page": "1",
      "sort": "bid",
      "tmall": "false"
    }
  }
}

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