Amazon Potential Product

1 credits/call
ae_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.

Productivity
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 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.

ParameterTypeRequiredDescriptionDefault
pageintegerNoThe page index of the query result. Defaults to page 1. Each page returns 20 records.1
amz_siteenum (Unknow | US | GB | DE)NoAmazon marketplace site.Unknow
price_maxnumberNoOptional: filter products with selling price less than or equal to this value.-9999
price_minnumberNoOptional: filter products with selling price greater than or equal to this value.-9999
search_namestringNoOptional: search related products by this name.""
delivery_typeenum (Both | FBM | FBA | AmzFBA)NoOptional: 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_maxintegerNoOptional: filter products with monthly sales volume less than or equal to this value.-9999
month_sales_volume_minintegerNoOptional: filter products with monthly sales volume greater than or equal to this value.-9999

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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