# SimilarWeb 竞品网站 API (similarweb.competitors)

- Canonical page: [https://everyinfra.com/similarweb-api/competitors](https://everyinfra.com/similarweb-api/competitors?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "similarweb", "action": "competitors", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list
- Mode: sync; add "mode": "async" for slow tasks

SimilarWeb 竞品网站按 `keyword` 里的域名，列出 SimilarWeb 判定与这个网站相似或有竞争关系的网站，每行带名称、链接、关系类型、分类、分类内排名，以及全球和所在国家的流量排名。它回答「这个网站的竞品有哪些、体量多大」，适合梳理竞品、寻找可参照的同类网站，或整理投放与合作的候选名单。

`keyword` 填域名，例如 example.com。`relation` 区分竞品、相似和关联三种关系；各项排名都是数字越小越靠前，`category_rank` 是在 `category` 里的名次，分类按 SimilarWeb 自己的体系。这些排名是 SimilarWeb 的估算，不是各网站自己的统计，适合在网站之间横向比较。

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 待分析的网站域名，例如 example.com；即使 action 名为 search，也不是全网关键词搜索。search 返回流量概览，competitors 返回相似网站，audience 返回单站受众资料。指标是第三方估算，不等于该站 GA4 实测。 |
| limit | integer (1–) | no | not declared | 这次调用最多返回的条数，整数，至少为 1；不传按默认值，实际返回可能少于这个数。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| relation | 与本站的关系类型（竞品 / 相似 / 关联）。 |
| category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
| category_rank | 所属分类内的流量排名。 |
| global_rank | 全球流量排名，数字越小越靠前。 |
| country_rank | 所在国家的流量排名。 |
| affinity | 受众兴趣偏好，推断出的访客还常去哪类站点。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| source_domain | 被查询的网站域名，这一行是它的竞争对手。 |

## 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": "similarweb",
  "action": "competitors",
  "params": {
    "keyword": "facebook.com"
  }
}'
```

```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": "similarweb",
        "action": "competitors",
        "params": {
            "keyword": "facebook.com",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 12. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "similarweb",
  "action": "competitors",
  "results": [
    {
      "id": "instagram.com",
      "url": "https://instagram.com",
      "name": "instagram.com",
      "relation": "similarity",
      "category": "computers_electronics_and_technology/social_networks_and_online_communities",
      "category_rank": 2,
      "affinity": 1,
      "platform": "similarweb",
      "source_domain": "facebook.com"
    },
    {
      "id": "reddit.com",
      "url": "https://reddit.com",
      "name": "reddit.com",
      "relation": "similarity",
      "category": "computers_electronics_and_technology/social_networks_and_online_communities",
      "category_rank": 5,
      "affinity": 0.8947368421052632,
      "platform": "similarweb",
      "source_domain": "facebook.com"
    }
  ],
  "count": 12,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### `keyword` 为什么填域名而不是关键词？

因为 SimilarWeb 竞品网站分析的是一个具体网站，不在全网搜索关键词。填网站域名即可，例如 example.com。同一个域名也可以传给 SimilarWeb 关键词搜索和受众画像：前者虽然叫搜索，实际返回这个网站的流量概览，后者返回访客画像，一份域名清单就能把三项都跑完。

### `relation` 的三种关系怎么用？

`relation` 标出结果里的网站和所查网站是什么关系：竞品、相似站或关联站。只要直接竞争对手时，按它筛出竞品；相似站和关联站适合用来扩充投放、合作或外链拓展的候选名单。

### 排名数字怎么读？

`global_rank` 是全球流量排名，`country_rank` 是在所在国家的排名，`category_rank` 是在所属分类里的排名，都是数字越小越靠前。小众网站看 `category_rank` 更公平；这些排名是 SimilarWeb 的估算，不是网站自己公布的数字。

## Also

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