# Amazon 竞品商品 API (amazon.product_competitors)

- Canonical page: https://everyinfra.com/amazon-api/product_competitors
- Endpoint: POST /api/v1/social with {"platform": "amazon", "action": "product_competitors", "params": {...}}
- Price: $0.01151 per call ($11.51 per 1,000 requests); failed and empty results are not charged
- Returns: list, default 20, max 100 per call (larger values are capped)
- Mode: sync; add "mode": "async" for slow tasks

竞品商品按 `asin` 找出和这个商品在搜索关键词上重叠最多的其他商品，返回一个列表，每行是一个竞品：共同关键词个数 `shared_keywords`、在这些词下的平均名次 `avg_position`，以及共同词里自然结果和广告位各占几个。想知道谁在抢同一批搜索词、新品要面对哪些对手，或者给广告投放挑对标商品，先看这个接口。

`asin` 是 10 位大写字母或数字的商品标识，不收列表，只查美国站，没有数据时返回空结果。结果按 `shared_keywords` 从多到少排，第一行就是重叠最大的竞品；`target_asin` 是你查的那一个，每行相同。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=amazon&action=product_competitors

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| asin | not declared | yes | not declared | 要查的商品 ASIN，一个 10 位大写字母/数字（例如 B0C2JXSHSK），不收列表。只查美国站；没有数据时返回空结果。 |
| limit | integer (1–100) | no | 20 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限照收，按上限返回。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| asin | Amazon 标准识别号，站内唯一商品标识。 |
| url | 该记录在原平台上的可访问链接。 |
| shared_keywords | 这个竞品和目标商品都排得上的搜索关键词个数（product_competitors），按它从多到少排。 |
| avg_position | 竞品在这些共同关键词下的平均名次（product_competitors），越小越靠前。 |
| shared_organic_keywords | 共同关键词里，竞品以自然结果出现的个数（product_competitors）。 |
| shared_organic_top10_keywords | 共同关键词里，竞品自然结果排进前 10 的个数（product_competitors）。 |
| shared_organic_search_volume | 竞品以自然结果出现的共同关键词，月搜索量合计（product_competitors）。 |
| shared_sponsored_keywords | 共同关键词里，竞品以广告位出现的个数（product_competitors）。 |
| shared_sponsored_search_volume | 竞品以广告位出现的共同关键词，月搜索量合计（product_competitors）。 |
| organic_keywords | 竞品自己全部排得上的关键词里，自然结果的个数（product_competitors，不限于共同词）。 |
| sponsored_keywords | 竞品自己全部排得上的关键词里，广告位的个数（product_competitors，不限于共同词）。 |
| target_asin | 这次查的目标商品 ASIN（product_competitors），每行相同。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "amazon",
  "action": "product_competitors",
  "params": {
    "asin": "B0C2JXSHSK"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "amazon",
        "action": "product_competitors",
        "params": {
            "asin": "B0C2JXSHSK",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "amazon",
  "action": "product_competitors",
  "results": [
    {
      "asin": …,
      "url": …,
      "shared_keywords": …,
      "avg_position": …,
      "shared_organic_keywords": …,
      "shared_organic_top10_keywords": …,
      "shared_organic_search_volume": …,
      "shared_sponsored_keywords": …,
      "shared_sponsored_search_volume": …,
      "organic_keywords": …,
      "sponsored_keywords": …,
      "target_asin": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### `avg_position` 越大还是越小越好？

越小越靠前。它是竞品在你们共同关键词下的平均名次，只统计共同词，不是竞品全部关键词的平均。一个竞品共同词很多、`avg_position` 却很大，说明重叠面广但名次靠后。

### `shared_organic_keywords` 和 `organic_keywords` 有什么区别？

前者只数你们共同关键词里竞品以自然结果出现的个数，后者数竞品自己全部排得上的关键词里自然结果的个数，不限于共同词。想看竞品的整体规模读后者，想看它和你的重叠读前者。

### 拿到竞品之后，怎么继续比较？

把筛出的几个竞品 ASIN 交给批量商品排名概览，一次最多 20 个，看各自排第 1、前 3、前 10 的词有多少；想看它们和你都排得上的具体词，用多个商品的共同关键词，传 2–10 个 ASIN。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=amazon
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md