Amazon Product Ranking Trend By Keyword
Look up an Amazon product's exposure ranking trend for a specific keyword, ordered by exposure time from newest to oldest. Provide the product ASIN and keyword. You can optionally select an Amazon marketplace and a results page; the marketplace defaults to Unknow, and page defaults to 1 with 20 records per page. This query concerns keyword exposure ranking, not sales ranking. The provider does not specify a fixed output schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Each call queries a page of keyword exposure ranking trend records for a single product ASIN and keyword. Requesting another page makes a new call and is charged separately. Billing does not depend on the number of returned records.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
asin | string | Yes | Product ASIN. | — |
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. | — |
amz_site | enum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. | Unknow |
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_product_ranking_trend_by_keyword' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"asin": "B07MHJFRBJ",
"keyword": "paper towels"
}
}'{
"data": [
{
"page": "Page 1",
"position": "Pos 17/59",
"position_name": "Organic",
"position_type": "Organic",
"time": "2026-10-20 11:50"
}
],
"doc": {
"page": "Page where the exposure occurred (e.g. \"Page 1\", \"Page 3\").",
"position": "Exposure position text (e.g. \"Pos X/Y\", X is the rank on the page, Y is the total number of exposure slots on the page).",
"position_name": "Exposure position name. Values: Organic position / SP ad / brand ad / video ad.",
"position_type": "Exposure position type. Values: Organic exposure / ad exposure.",
"time": "Exposure time, in yyyy-MM-dd HH:mm format."
}
}This example shows part of the response. Copied content is valid JSON.

