AgentEarth
登录

Ae · Amazon · Product · Search

1.00积分/次
ae_amazon_product_search

实时搜索亚马逊平台商品数据，支持按站点、品牌、价格区间、月销量、评分及发货方式等多维度条件进行筛选查询。

效率工具
1.00积分/次

价格说明

1.00积分/次

API 调用

通过统一工具网关发起同步请求，鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_amazon_product_search",
  "input": {
    "page": "1",
    "brand": "xxx",
    "amz_site": "Unknow",
    "price_max": "-9999",
    "price_min": "-9999",
    "ratings_max": "-9999",
    "ratings_min": "-9999",
    "search_name": "xxx",
    "seller_name": "xxx",
    "delivery_type": "Both",
    "property_name": "xxx",
    "ratings_count_max": "-9999",
    "ratings_count_min": "-9999",
    "variation_count_max": "-9999",
    "variation_count_min": "-9999",
    "month_sales_volume_max": "-9999",
    "month_sales_volume_min": "-9999",
    "sortby_potential_index": "false",
    "seasonal_popular_product": "Both",
    "subcategory_sales_volume_rank_max": "-9999",
    "subcategory_sales_volume_rank_min": "-9999"
  }
}'
请求方式
POST
接口地址
/v1/tools/run
鉴权方式
Bearer Token
超时时间
60 秒
当前版本
—
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
pageinteger否The page index of the query result. Defaults to page 1. Each page returns 20 records.1
brandstring否Optional: filter products of the specified brand.—
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)否Amazon marketplace site. Unknow
price_maxnumber否Optional: filter products with selling price less than or equal to this value.-9999
price_minnumber否Optional: filter products with selling price greater than or equal to this value.-9999
ratings_maxnumber否Optional: filter products with star rating less than or equal to this value.-9999
ratings_minnumber否Optional: filter products with star rating greater than or equal to this value.-9999
search_namestring否Optional: search related products by this name.—
seller_namestring否Optional: filter products of the specified seller.—
delivery_typeenum (Both | FBM | FBA | AmzFBA)否Optional: filter products by fulfillment method. Allowed values: `Both` (default, no filter), `FBM` (seller-fulfilled), `FBA` (any product using Amazon FBA, including seller-shipped and third-party like 1688), `AmzFBA` (third-party seller using Amazon FBA, e.g. 1688).Both
property_namestring否Optional: filter products whose title or attributes contain the specified property.—
ratings_count_maxinteger否Optional: filter products with review count less than or equal to this value.-9999
ratings_count_mininteger否Optional: filter products with review count greater than or equal to this value.-9999
variation_count_maxinteger否Optional: filter products whose variation (child ASIN) count is less than or equal to this value.-9999
variation_count_mininteger否Optional: filter products whose variation (child ASIN) count is greater than or equal to this value.-9999
month_sales_volume_maxinteger否Optional: filter products with monthly sales volume less than or equal to this value.-9999
month_sales_volume_mininteger否Optional: filter products with monthly sales volume greater than or equal to this value.-9999
sortby_potential_indexboolean否Optional: if true, sort by the product's potential index from high to low.false
seasonal_popular_productenum (Both | January | February | March | April | May | June | July | August | September | October | November | December)否Optional: filter products that are in peak season in the specified month. Defaults to Both.Both
subcategory_sales_volume_rank_maxinteger否Optional: filter products whose sales volume rank in the subcategory is less than or equal to this value.-9999
subcategory_sales_volume_rank_mininteger否Optional: filter products whose sales volume rank in the subcategory is greater than or equal to this value.-9999