Amazon Product Ranking Trend By Keyword

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

Productivity
1 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
asinstringYesProduct ASIN.—
pageintegerNoThe page index of the query result. Defaults to page 1. Each page returns 20 records.1
keywordstringYesThe keyword.—
amz_siteenum (Unknow | US | GB | DE | FR | IN | 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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.