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

# get_amazon_competitors

> The products that compete with one Amazon product in search, with how many terms they share. ₹2.22 per call; a result that finds nothing is ₹0.

## What it does

The products that compete with an Amazon listing in search: data with up to 100 ASINs that rank for the same keywords, each with how many keywords it shares, its average position and visibility, in one Amazon market.

Use it to map a category from one product you know; [`get_amazon_ranked_keywords`](https://parel.si/docs/tools/get_amazon_ranked_keywords.md) shows the keywords, [`get_amazon_product`](https://parel.si/docs/tools/get_amazon_product.md) each competitor's listing, get_amazon_reviews what buyers say about them. Flat price per call. Under five seconds.

India: location_code 2356 where covered, 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 products, 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 products. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹2.22** per call (`cost_paise: 222`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹3.33 (`hold_paise: 333`); 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_competitors"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_amazon_competitors"` |
| 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_competitors","input":{"asin":"B00R92CL5E","limit":20,"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": 166,
  "items_count": 20,
  "items": [
    {
      "se_type": "amazon",
      "asin": "B00R92CL5E",
      "avg_position": 6.8125,
      "sum_position": 218,
      "intersections": 32,
      "competitor_metrics": {
        "amazon_serp": {
          "pos_1": 10,
          "pos_2_3": 1,
          "pos_4_10": 13,
          "pos_11_100": 8,
          "count": 32,
          "search_volume": 741
        },
        "amazon_paid": {
          "pos_1": 0,
          "pos_2_3": 0,
          "pos_4_10": 0,
          "pos_11_100": 0,
          "count": 0,
          "search_volume": 0
        }
      },
      "full_metrics": {
        "amazon_serp": {
          "pos_1": 10,
          "pos_2_3": 1,
          "pos_4_10": 13,
          "pos_11_100": 8,
          "count": 32,
          "search_volume": 741
        },
        "amazon_paid": {
          "pos_1": 0,
          "pos_2_3": 0,
          "pos_4_10": 0,
          "pos_11_100": 0,
          "count": 0,
          "search_volume": 0
        }
      }
    },
    {
      "se_type": "amazon",
      "asin": "B014YN7LVE",
      "avg_position": 3,
      "sum_position": 78,
      "intersections": 26,
      "competitor_metrics": {
        "amazon_serp": {
          "pos_1": 4,
          "pos_2_3": 16,
          "pos_4_10": 5,
          "pos_11_100": 1,
          "count": 26,
          "search_volume": 741
        },
        "amazon_paid": {
          "pos_1": 0,
          "pos_2_3": 0,
          "pos_4_10": 0,
          "pos_11_100": 0,
          "count": 0,
          "search_volume": 0
        }
      },
      "full_metrics": {
        "amazon_serp": {
          "pos_1": 93,
          "pos_2_3": 221,
          "pos_4_10": 445,
          "pos_11_100": 666,
          "count": 1425,
          "search_volume": 257652
        },
        "amazon_paid": {
          "pos_1": 21,
          "pos_2_3": 33,
          "pos_4_10": 91,
          "pos_11_100": 1,
          "count": 146,
          "search_volume": 3269
        }
      }
    },
    {
      "se_type": "amazon",
      "asin": "B083R46CV8",
      "avg_position": 4.8,
      "sum_position": 96,
      "intersections": 20,
      "competitor_metrics": {
        "amazon_serp": {
          "pos_1": 5,
          "pos_2_3": 4,
          "pos_4_10": 9,
          "pos_11_100": 2,
          "count": 20,
          "search_volume": 593
        },
        "amazon_paid": {
          "pos_1": 0,
          "pos_2_3": 0,
          "pos_4_10": 0,
          "pos_11_100": 0,
          "count": 0,
          "search_volume": 0
        }
      },
      "full_metrics": {
        "amazon_serp": {
          "pos_1": 105,
          "pos_2_3": 157,
          "pos_4_10": 600,
          "pos_11_100": 713,
          "count": 1575,
          "search_volume": 206434
        },
        "amazon_paid": {
          "pos_1": 11,
          "pos_2_3": 21,
          "pos_4_10": 40,
          "pos_11_100": 0,
          "count": 72,
          "search_volume": 1771
        }
      }
    }
  ]
}
```

## Notes

- Flat per call for up to 100 products.
- From the source's index of Amazon results, refreshed regularly.
- Pairs with get_amazon_ranked_keywords and get_amazon_product.

## Siblings

- [`get_amazon_ranked_keywords`](https://parel.si/docs/tools/get_amazon_ranked_keywords.md)
- [`get_amazon_product`](https://parel.si/docs/tools/get_amazon_product.md)
