> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_amazon_ranked_keywords

# get_amazon_ranked_keywords

> The search terms an Amazon product ranks for, with position and volume. ₹1.75 per call; a result that finds nothing is ₹0.

## What it does

The keywords an Amazon listing ranks for in Amazon's own search, with the position and the keyword's search volume: data with up to 100 keywords a call for one ASIN in one Amazon market.

Use it to see what shoppers type to reach a competitor's product, and which of those searches you are missing; [`get_amazon_competitors`](https://parel.si/docs/tools/get_amazon_competitors.md) lists the products that rank beside it, [`search_amazon`](https://parel.si/docs/tools/search_amazon.md) shows a keyword's results today. Flat price per call. Under five seconds.

India: location_code 2356 for amazon.in where the source covers it, 2840 for the US store.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `asin` | string | one of | The product's ASIN. |
| `limit` | integer | no | How many keywords, up to 100.; max 100 |
| `language_code` | string | no | Two-letter language code ("en"). |
| `location_code` | integer | no | Amazon market as a numeric code: 2840 is the United States, 2356 India. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `asin`.

## What drives the cost

Flat per call for up to 100 keywords. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.75** per call (`cost_paise: 175`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.63 (`hold_paise: 263`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_amazon_ranked_keywords"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_amazon_ranked_keywords"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_amazon_ranked_keywords","input":{"asin":"B00R92CL5E","limit":50,"language_code":"en","location_code":2840}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "se_type": "amazon",
  "asin": "B00R92CL5E",
  "location_code": 2840,
  "language_code": "en",
  "total_count": 32,
  "items_count": 32,
  "items": [
    {
      "se_type": "amazon",
      "keyword_data": {
        "se_type": "amazon",
        "keyword": "netgear wifi ex3700",
        "location_code": 2840,
        "language_code": "en",
        "keyword_info": {
          "se_type": "amazon",
          "last_updated_time": "2026-10-03 03:35:51 +00:00",
          "search_volume": 0
        }
      },
      "ranked_serp_element": {
        "se_type": "amazon",
        "serp_item": {
          "se_type": "amazon",
          "type": "amazon_serp",
          "rank_group": 1,
          "rank_absolute": 1,
          "position": "left",
          "xpath": "/html[1]/body[1]/div[1]/div[1]/div[1]/div[1]/div[1]/span[1]/div[1]/div[3]",
          "domain": "www.amazon.com",
          "title": "Nighthawk WiFi Extender EX3700, up to 1,000 sq ft, 750 Mbps",
          "url": "https://www.amazon.com/NETGEAR-Wi-Fi-Range-Extender-EX3700/dp/B00R92CL5E/ref=sr_1_1?crid=IZDCV6447O8N&dib=eyJ2IjoiMSJ9.2XtjzRaAlVyY7FVXY8EnaWhg_fNQ3Yrt5zcoPt7GpemITOER4wPZybEnDq9z1ezShvgGfqkbejdJv9whufvEZ3mAqbcj84SBzlheDB6dh0TCt0dvslIHWGWNO…",
          "asin": "B00R92CL5E",
          "image_url": "https://m.media-amazon.com/images/I/61z5oOk5fzL._AC_UY218_.jpg",
          "price_from": null,
          "price_to": null,
          "currency": null,
          "special_offers": null,
          "is_best_seller": false,
          "is_amazon_choice": false,
          "rating": {
            "rating_type": "Max5",
            "value": 3,
            "votes_count": 76400,
            "rating_max": 5
          },
          "delivery_info": null,
          "bought_past_month": 750
        },
        "check_url": "https://www.amazon.com/s?k=netgear+wifi+ex3700&crid=IZDCV6447O8N&sprefix=netgear%2Bwifi%2Bex3700%2Caps%2C249&language=en_US&ref=nb_sb_noss",
        "serp_item_types": [
          "amazon_serp",
          "amazon_paid"
        ],
        "se_results_count": 62,
        "last_updated_time": "2026-09-26 19:05:03 +00:00",
        "previous_updated_time": "2026-07-28 20:33:36 +00:00"
      }
    },
    {
      "se_type": "amazon",
      "keyword_data": {
        "se_type": "amazon",
        "keyword": "netgear wifi extender ex3700",
        "location_code": 2840,
        "language_code": "en",
        "keyword_info": {
          "se_type": "amazon",
          "last_updated_time": "2026-11-03 01:42:40 +00:00",
          "search_volume": 74
        }
      },
      "ranked_serp_element": {
        "se_type": "amazon",
        "serp_item": {
          "se_type": "amazon",
          "type": "amazon_serp",
          "rank_group": 1,
          "rank_absolute": 1,
          "position": "left",
          "xpath": "/html[1]/body[1]/div[1]/div[1]/div[1]/div[1]/div[1]/span[1]/div[1]/div[3]",
          "domain": "www.amazon.com",
          "title": "Nighthawk WiFi Extender EX3700, up to 1,000 sq ft, 750 Mbps",
          "url": "https://www.amazon.com/NETGEAR-Wi-Fi-Range-Extender-EX3700/dp/B00R92CL5E/ref=sr_1_1?crid=HV04IGDKLWOT&dib=eyJ2IjoiMSJ9.2XtjzRaAlVyY7FVXY8EnaaH2RwTxp4XGDVSLQLqslawXlwCv7LcSpfa2rzuXqC6YhvgGfqkbejdJv9whufvEZwUqt4XY-SNiT40DRbO2XqrI95lbTSJFNyPNb…",
          "asin": "B00R92CL5E",
          "image_url": "https://m.media-amazon.com/images/I/61z5oOk5fzL._AC_UY218_.jpg",
          "price_from": null,
          "price_to": null,
          "currency": null,
          "special_offers": null,
          "is_best_seller": false,
          "is_amazon_choice": false,
          "rating": {
            "rating_type": "Max5",
            "value": 3,
            "votes_count": 76400,
            "rating_max": 5
          },
          "delivery_info": null,
          "bought_past_month": 750
        },
        "check_url": "https://www.amazon.com/s?k=netgear+wifi+extender+ex3700&crid=HV04IGDKLWOT&sprefix=netgear%2Bwifi%2Bextender%2Bex3700%2Caps%2C254&language=en_US&ref=nb_sb_noss",
        "serp_item_types": [
          "amazon_serp",
          "amazon_paid",
          "related_searches"
        ],
        "se_results_count": 280,
        "last_updated_time": "2026-09-26 19:05:23 +00:00",
        "previous_updated_time": "2026-07-28 20:33:10 +00:00"
      }
    },
    {
      "se_type": "amazon",
      "keyword_data": {
        "se_type": "amazon",
        "keyword": "netgear ex3700 wifi extender",
        "location_code": 2840,
        "language_code": "en",
        "keyword_info": {
          "se_type": "amazon",
          "last_updated_time": "2026-10-03 10:55:41 +00:00",
          "search_volume": 37
        }
      },
      "ranked_serp_element": {
        "se_type": "amazon",
        "serp_item": {
          "se_type": "amazon",
          "type": "amazon_serp",
          "rank_group": 1,
          "rank_absolute": 1,
          "position": "left",
          "xpath": "/html[1]/body[1]/div[1]/div[1]/div[1]/div[1]/div[1]/span[1]/div[1]/div[3]",
          "domain": "www.amazon.com",
          "title": "Nighthawk WiFi Extender EX3700, up to 1,000 sq ft, 750 Mbps",
          "url": "https://www.amazon.com/NETGEAR-Wi-Fi-Range-Extender-EX3700/dp/B00R92CL5E/ref=sr_1_1?crid=08RGYRRJREAQ&dib=eyJ2IjoiMSJ9.2XtjzRaAlVyY7FVXY8EnaTKlFRIrKhc-eTn77AXbp4yITOER4wPZybEnDq9z1ezShvgGfqkbejdJv9whufvEZ_eBpZ2-Ok59j9XLD3DqQkAxhQVLqZZX5lUQO…",
          "asin": "B00R92CL5E",
          "image_url": "https://m.media-amazon.com/images/I/61z5oOk5fzL._AC_UY218_.jpg",
          "price_from": null,
          "price_to": null,
          "currency": null,
          "special_offers": null,
          "is_best_seller": false,
          "is_amazon_choice": false,
          "rating": {
            "rating_type": "Max5",
            "value": 3,
            "votes_count": 76400,
            "rating_max": 5
          },
          "delivery_info": null,
          "bought_past_month": 750
        },
        "check_url": "https://www.amazon.com/s?k=netgear+ex3700+wifi+extender&crid=08RGYRRJREAQ&sprefix=netgear%2Bex3700%2Bwifi%2Bextender%2Caps%2C261&language=en_US&ref=nb_sb_noss",
        "serp_item_types": [
          "amazon_serp",
          "amazon_paid"
        ],
        "se_results_count": 299,
        "last_updated_time": "2026-09-26 19:14:05 +00:00",
        "previous_updated_time": "2026-07-28 20:41:55 +00:00"
      }
    }
  ]
}
```

## Notes

- Flat per call for up to 100 keywords.
- The source's index of Amazon search results, refreshed regularly; search_amazon is the live page.
- Pairs with get_amazon_competitors.

## Siblings

- [`get_amazon_competitors`](https://parel.si/docs/tools/get_amazon_competitors.md)
- [`search_amazon`](https://parel.si/docs/tools/search_amazon.md)
