Amazon Seller Search
Search for Amazon sellers by combining marketplace and category filters with ranges for catalog size, brand coverage, estimated monthly sales volume, listing monthly sales amount, average product price, feedback, product ratings counts, FBM and A+ product counts, variations, and no-brand product metrics. You can also filter by seller online date and Chinese or non-Chinese sellers. Useful for seller discovery and competitor screening. Top100 product and brand counts are separate from total product and brand counts. All inputs are optional. Minimum and maximum bounds are inclusive; monetary values use the local currency's smallest unit, such as cents for the US marketplace, and ratios use 0–100 percentages. Dates use yyyy-MM-dd. Pagination defaults to page 1 with 20 records per page. The provider has not defined an output schema, so specific returned fields are not guaranteed.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Each separate page request is charged as a call. Marketplace and filter selections do not change the per-call charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Page index, default 1, 20 records per page. | 1 |
node_id | string | No | Optional: query sellers by category (not limited to sub-categories). Example: 3743561. | "" |
amz_seller_site | enum (Unknow | US | GB | DE | FR | CA | JP | ES | IT | MX) | No | Amazon marketplace site. Allowed: US、GB、DE、FR、CA、JP、ES、IT、MX. | Unknow |
brand_count_max | integer | No | Optional: filter sellers whose number of brands with products ranked in the sub-category Top100 is less than or equal to this value. | 0 |
brand_count_min | integer | No | Optional: filter sellers whose number of brands with products ranked in the sub-category Top100 is greater than or equal to this value. | 0 |
average_price_max | integer | No | Optional: filter sellers whose average product price is less than or equal to this value, in the smallest unit of the local currency (e.g. cents for the US site). | 0 |
average_price_min | integer | No | Optional: filter sellers whose average product price is greater than or equal to this value, in the smallest unit of the local currency (e.g. cents for the US site). | 0 |
is_chinese_seller | integer | No | Optional: restrict to Chinese sellers (value 1) or non-Chinese sellers (value 2). Defaults to 0. | 0 |
product_count_max | integer | No | Optional: filter sellers whose number of products ranked in the sub-category Top100 (Best Seller) is less than or equal to this value. | 0 |
product_count_min | integer | No | Optional: filter sellers whose number of products ranked in the sub-category Top100 (Best Seller) is greater than or equal to this value. | 0 |
category_count_max | integer | No | Optional: filter sellers whose number of operating categories is less than or equal to this value. | 0 |
category_count_min | integer | No | Optional: filter sellers whose number of operating categories is greater than or equal to this value. | 0 |
feedback_count_max | integer | No | Optional: filter sellers whose feedback count is less than or equal to this value. | 0 |
feedback_count_min | integer | No | Optional: filter sellers whose feedback count is greater than or equal to this value. | 0 |
fbm_product_count_max | integer | No | Optional: filter sellers whose FBM product count is less than or equal to this value. | 0 |
fbm_product_count_min | integer | No | Optional: filter sellers whose FBM product count is greater than or equal to this value. | 0 |
total_brand_count_max | integer | No | Optional: filter sellers whose total brand count is less than or equal to this value. | 0 |
total_brand_count_min | integer | No | Optional: filter sellers whose total brand count is greater than or equal to this value. | 0 |
monthly_sale_count_max | integer | No | Optional: filter sellers whose estimated total monthly sales volume is less than or equal to this value. | 0 |
monthly_sale_count_min | integer | No | Optional: filter sellers whose estimated total monthly sales volume is greater than or equal to this value. | 0 |
seller_online_date_end | string | No | Optional: filter sellers whose online date is not later than this time. Format: yyyy-MM-dd. Example: 2020-12-31. | "" |
sub_category_count_max | integer | No | Optional: filter sellers whose number of operating sub-categories is less than or equal to this value. | 0 |
sub_category_count_min | integer | No | Optional: filter sellers whose number of operating sub-categories is greater than or equal to this value. | 0 |
product_count_ratio_max | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sellers whose ratio of products ranked in the sub-category Top100 is less than or equal to this value. | 0 |
product_count_ratio_min | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sellers whose ratio of products ranked in the sub-category Top100 is greater than or equal to this value. | 0 |
total_product_count_max | integer | No | Optional: filter sellers whose total product count is less than or equal to this value. | 0 |
total_product_count_min | integer | No | Optional: filter sellers whose total product count is greater than or equal to this value. | 0 |
a_plus_product_count_max | integer | No | Optional: filter sellers whose product count with A+ content is less than or equal to this value. | 0 |
a_plus_product_count_min | integer | No | Optional: filter sellers whose product count with A+ content is greater than or equal to this value. | 0 |
seller_online_date_start | string | No | Optional: filter sellers whose online date is not earlier than this time. Format: yyyy-MM-dd. Example: 2017-01-01. | "" |
average_ratings_count_max | integer | No | Optional: filter sellers whose average product ratings count is less than or equal to this value. | 0 |
average_ratings_count_min | integer | No | Optional: filter sellers whose average product ratings count is greater than or equal to this value. | 0 |
total_variation_count_max | integer | No | Optional: filter sellers whose total variation count is less than or equal to this value. | 0 |
total_variation_count_min | integer | No | Optional: filter sellers whose total variation count is greater than or equal to this value. | 0 |
no_brand_product_count_max | integer | No | Optional: filter sellers whose no-brand product count is less than or equal to this value. | 0 |
no_brand_product_count_min | integer | No | Optional: filter sellers whose no-brand product count is greater than or equal to this value. | 0 |
average_variation_count_max | integer | No | Optional: filter sellers whose average variation count is less than or equal to this value. | 0 |
average_variation_count_min | integer | No | Optional: filter sellers whose average variation count is greater than or equal to this value. | 0 |
listing_monthly_sale_amount_max | integer | No | Optional: filter sellers whose listing monthly sales amount is less than or equal to this value, in the smallest unit of the local currency (e.g. cents for the US site). | 0 |
listing_monthly_sale_amount_min | integer | No | Optional: filter sellers whose listing monthly sales amount is greater than or equal to this value, in the smallest unit of the local currency (e.g. cents for the US site). | 0 |
no_brand_product_count_ratio_max | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sellers whose no-brand product count ratio is less than or equal to this value. | 0 |
no_brand_product_count_ratio_min | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sellers whose no-brand product count ratio is greater than or equal to this value. | 0 |
no_brand_product_sales_ratio_max | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sellers whose no-brand product sales ratio is less than or equal to this value. | 0 |
no_brand_product_sales_ratio_min | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sellers whose no-brand product sales ratio is greater than or equal to this value. | 0 |
no_brand_product_monthly_sales_max | integer | No | Optional: filter sellers whose no-brand product listing monthly sales volume is less than or equal to this value. | 0 |
no_brand_product_monthly_sales_min | integer | No | Optional: filter sellers whose no-brand product listing monthly sales volume is 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_amazon_seller_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_seller_site": "US",
"average_price_max": 6000,
"average_price_min": 1500,
"fbm_product_count_min": 20,
"is_chinese_seller": 1,
"page": 1,
"total_brand_count_min": 20,
"total_product_count_min": 50
}
}'{
"data": [
{
"a_plus_product_count": 0,
"average_price": 26.01,
"average_ratings_count": 2,
"average_variation_count": 15,
"brand_count": 52,
"category_count": 5
}
],
"doc": {
"a_plus_product_count": "Product count with A+ content.",
"average_price": "Average product price (USD).Value -1: no data for that period.",
"average_ratings_count": "Average review count of products.",
"average_variation_count": "Average variation quantity per listing.",
"brand_count": "Brand count of seller's Top100 products.",
"category_count": "Count of operated main categories."
}
}This example shows part of the response. Copied content is valid JSON.

