Ranking
3 tools for keyword rank tracking, rank changes, and rank positions joined with search volume.
get_keyword_ranksReadGet keyword rank positions from daily snapshots. Shows where your ASINs appear in Amazon catalog search results for tracked keywords.
When to use
Monitor organic search visibility over time, track ranking trends for your tracked keywords, and identify ranking gains or losses.
Parameters
| Name | Type | Description |
|---|---|---|
start_date* | string | Start date (YYYY-MM-DD). |
end_date | string | End date (YYYY-MM-DD). Defaults to start_date for a single day. |
keyword | string | Filter by keyword (LIKE match, use % for wildcards). |
asin | string | Filter by ASIN (exact match). |
min_rank | number | Minimum rank position to include. |
max_rank | number | Maximum rank position to include (e.g. 20 for page 1 only). |
sort_by | enum (rank_position) | Column to sort by: snapshot_date, keyword, asin, rank_position, page, total_results. |
sort_order | enum (asc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
* required
Tips
- Use max_rank=20 to focus on page 1 results only (20 results per page).
- Query a date range to see how rankings have trended over time for specific keywords.
- Filter by ASIN to see all keywords where that product ranks.
Watch out
- Rank snapshots are taken daily. For real-time rank checks, use get_current_rank instead.
Related tools
get_rank_changesReadCompare keyword rank positions between two dates. Shows which keywords improved or dropped in rank. Positive rank_change means improvement (moved up), negative means decline.
When to use
Measure the impact of SEO or advertising changes by comparing rank positions before and after the change.
Parameters
| Name | Type | Description |
|---|---|---|
current_date* | string | The more recent snapshot date (YYYY-MM-DD). |
compare_date* | string | The earlier snapshot date to compare against (YYYY-MM-DD). |
keyword | string | Filter by keyword (LIKE match, use % for wildcards). |
asin | string | Filter by ASIN (exact match). |
min_change | number | Minimum absolute rank change to include. Filters out noise from small position shuffles. |
sort_by | enum (rank_change) | Column to sort by: rank_change, keyword, asin, current_rank, prev_rank. |
sort_order | enum (desc) | Sort direction. Default desc shows biggest improvements first. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
* required
Tips
- Use min_change=5 or higher to filter out normal day-to-day rank fluctuations.
- Sort descending to see biggest improvements first, ascending to see biggest drops first.
- Compare dates at least 7 days apart to filter out daily noise.
Watch out
- Only keywords tracked on both dates will appear. New or dropped keywords are excluded from the comparison.
get_rank_with_volumeReadGet keyword rank positions enriched with SQP search volume and market share data. Joins daily rank snapshots with the SQP week containing the snapshot date.
When to use
Inspect keyword rank position, search volume, and SQP market-share fields in one result set.
Parameters
| Name | Type | Description |
|---|---|---|
snapshot_date* | string | Rank snapshot date (YYYY-MM-DD). SQP volume is auto-matched to the week containing this date. |
keyword | string | Filter by keyword (LIKE match, use % for wildcards). |
asin | string | Filter by ASIN (exact match). |
max_rank | number | Maximum rank position to include (e.g. 20 for page 1 only). |
min_volume | number | Minimum search query volume. |
sort_by | enum (search_query_volume) | Column to sort by: search_query_volume, rank_position, keyword, asin, and all SQP share metrics. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
* required
Tips
- Sort by search_query_volume and filter by max_rank to list high-volume keywords within a selected rank-position range.
- Compare asin_impression_share_pct vs asin_purchase_share_pct to find keywords where you over-index on conversion.
- Use min_volume to filter out long-tail keywords with insufficient traffic to matter.
- The market_cr and brand_cr fields help you understand conversion rate advantage.
Watch out
- SQP data is weekly. The join matches the snapshot_date to the SQP week containing that date (Sunday through Saturday).