Amazon Product Traffic Terms
Find Amazon search keywords for a product by ASIN. The lookup returns keywords for which the product has recently appeared within the first three search-result pages, sorted by most recent exposure first. ASIN is required; amz_site optionally selects a supported marketplace and defaults to "Unknow". Use page to browse results: it defaults to 1, with 20 records per page. The exact recent time window and a fixed output schema are not specified by the provider.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
The page parameter selects the query result page to return. The Amazon search result page range used to qualify keywords is separate from query result pagination.
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 |
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_traffic_terms' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"asin": "B0H2LWSRW9",
"page": 1
}
}'{
"data": [
{
"exposure_position": "Organic",
"keyword": "gutter cleaning tools",
"latest_ad_exposure_time": "",
"latest_ad_position": "",
"latest_organic_exposure_time": "2026-11-12 10:45",
"latest_organic_position": "Page 3, Pos 33/48"
}
],
"doc": {
"exposure_position": "Product's exposure position type (organic / ad / both, comma-separated).",
"keyword": "The reverse-looked-up keyword.",
"latest_ad_exposure_time": "Latest ad exposure time (yyyy-MM-dd HH:mm); empty when no exposure.",
"latest_ad_position": "Latest ad exposure position text (e.g. \"Page X, Pos Y/Z\"); empty when no exposure.",
"latest_organic_exposure_time": "Latest organic exposure time (yyyy-MM-dd HH:mm); empty when no exposure.",
"latest_organic_position": "Latest organic exposure position text (e.g. \"Page X, Pos Y/Z\"); empty when no exposure."
}
}This example shows part of the response. Copied content is valid JSON.

