Amazon Potential Product
Search for potential Amazon products for product-selection research. Narrow the search by product name, marketplace, selling-price range, monthly-sales-volume range, and fulfillment method. Marketplace values include US, GB, DE, and the default Unknow. Fulfillment options are Both, FBM, FBA, and AmzFBA, with provider-specific definitions in the parameter descriptions. Price and sales-volume limits are inclusive. Results are paginated, with page 1 as the default and 20 records per page. The provider does not define a fixed output schema; product candidates do not constitute a guarantee of profitability.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Product name, marketplace, price range, monthly sales range, and fulfillment filters do not affect the per-call charge. Each pagination request is charged as a separate call; billing is not based on the number of products returned.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | The page index of the query result. Defaults to page 1. Each page returns 20 records. | 1 |
amz_site | enum (Unknow | US | GB | DE) | No | Amazon marketplace site. | Unknow |
price_max | number | No | Optional: filter products with selling price less than or equal to this value. | -9999 |
price_min | number | No | Optional: filter products with selling price greater than or equal to this value. | -9999 |
search_name | string | No | Optional: search related products by this name. | "" |
delivery_type | enum (Both | FBM | FBA | AmzFBA) | No | 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 |
month_sales_volume_max | integer | No | Optional: filter products with monthly sales volume less than or equal to this value. | -9999 |
month_sales_volume_min | integer | No | Optional: filter products with monthly sales volume greater than or equal to this value. | -9999 |
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_potential_product' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"delivery_type": "FBM",
"page": 1,
"price_max": 80,
"price_min": 25,
"search_name": "tripod ball head"
}
}'{
"data": [
{
"a_plus": false,
"asin": "B00Z17TLMA",
"brand": "Benro",
"buybox_seller": "CameraSpot",
"category": [
""
],
"title": "Benro Ball Head – Compact Aluminum Arca-Swiss Compatible Ball Head with Quick Release Plate, Independent Pan Lock, and Smooth 360° Rotation for DSLR, Mirrorless & Travel Tripods (IN00)"
}
],
"doc": {
"a_plus": "Whether A+ content page exists.",
"asin": "Product ASIN.",
"brand": "Brand name.",
"buybox_seller": "Name of buy box owner.",
"data": "Array of product items. Each item contains the following fields:",
"title": "Product title."
},
"page": 1,
"page_count": 1
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

