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.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 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.
| 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 |
keyword | string | Yes | The keyword to query. | — |
position_type | integer | No | Exposure position type. 0: all, 1: organic only (default), 2: ads only. | 1 |
keyword_support_site | enum (Unknow | US | GB | DE | FR | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. | Unknow |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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.

