Amazon Keyword Search Results

1 credits/call
ae_amazon_keyword_search_results

Look up products appearing in Amazon search results for a keyword. Enter a keyword and optionally choose a marketplace, result page, and placement type: organic only (default), ads only, or all. Pages default to 1, with 20 records per page as documented by the provider. The provider does not define a fixed output schema.

Productivity
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

The keyword, marketplace, result page number, and position type (organic only, ads only, or all) do not affect the fixed charge per call. Charges are based on the number of calls, not 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
keywordstringYesThe keyword to query.—
position_typeintegerNoExposure position type. 0: all, 1: organic only (default), 2: ads only.1
keyword_support_siteenum (Unknow | US | GB | DE | FR | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site.Unknow

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_keyword_search_results' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "satchel bags for women",
    "keyword_support_site": "US",
    "page": 1,
    "position_type": 1
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "asin": "B0FKHBTZLC",
      "brand": "Bagstellar",
      "monthly_sales_volume": 16153,
      "monthly_sales_volume_share_in_top100": "15.17%",
      "price": 32.99,
      "title": "Bagstellar Corduroy Tote Bag for Women, 17 Pockets Laptop Work Tote Purse"
    }
  ],
  "doc": {
    "asin": "Product ASIN.",
    "brand": "Product brand.",
    "monthly_sales_volume": "Monthly sales volume of this product.",
    "monthly_sales_volume_share_in_top100": "This product's monthly sales share within the top 100 of the keyword's search results.",
    "price": "Product price(in USD).",
    "title": "Product title."
  }
}

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