Tool Reference
Ranking Tools
1 tools
Keyword rank positions, changes over time, and search volume views.
Related paths
Amazon Seller Central MCP
Hosted Amazon Seller Central MCP overview for Claude, ChatGPT, and custom agents.
Amazon seller data layerHow ads, inventory, orders, catalog, ranking, finance, and fulfillment data are structured for agents.
Claude connection walkthroughStep-by-step path from Seller Central OAuth to a Claude connector or MCP config.
ChatGPT Seller Central setupChatGPT-specific setup and examples for Amazon seller data through MCP.
Tools (1)
read
get_keyword_ranks
readGet keyword rank positions, two-date rank changes, or rank positions enriched with SQP search volume and market share data.
When to use
Use this source-surface tool for tracked keyword rank snapshots, deterministic rank deltas, or rank rows joined to the SQP week containing the snapshot date.
Parameters16
| Name | Type | Description |
|---|---|---|
view | enum (positions) | positions returns rank snapshots; changes compares two dates; with_volume joins rank rows to SQP volume/share. |
start_date | string (7 days ago) | positions view. Start date (YYYY-MM-DD). Defaults to a trailing 7-day window when omitted. |
end_date | string | positions view. End date (YYYY-MM-DD). Defaults to start_date. |
current_date | string (latest snapshot) | changes view. More recent snapshot date (YYYY-MM-DD). When both dates are omitted, the two most recent snapshots are compared. |
compare_date | string (previous snapshot) | changes view. Earlier snapshot date to compare (YYYY-MM-DD). When both dates are omitted, the two most recent snapshots are compared. |
snapshot_date | string (latest snapshot) | with_volume view. Rank snapshot date (YYYY-MM-DD). Defaults to the latest available snapshot. |
keyword | string | Filter by keyword (LIKE match, use % for wildcards). |
asin | string | Filter by ASIN. |
min_rank | number | positions view. Minimum rank position. |
max_rank | number | positions/with_volume views. Maximum rank position. |
min_change | number | changes view. Minimum absolute rank change. |
min_volume | number | with_volume view. Minimum SQP search query volume. |
sort_by | enum | Sort column. Allowed columns depend on view. |
sort_order | enum | Sort direction. Defaults depend on view. |
limit | number (20) | Max rows (1-1000). |
include_raw_rows | boolean (true) | Set false to return a compact row preview. Defaults to true; large result sets are capped automatically to keep the response manageable. |
Tips
- Use view="positions" with start_date/end_date for raw rank snapshots.
- Use view="changes" with current_date and compare_date for deterministic rank deltas.
- Use view="with_volume" with snapshot_date to join rank rows to SQP weekly volume/share data.
Watch out
- Rank snapshots are daily. view="with_volume" joins snapshot_date to the SQP week containing that date. For real-time rank checks, use get_current_rank.