# SimilarWeb 受众画像 API (similarweb.audience)

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

SimilarWeb 受众画像按 `keyword` 里的域名读取一个网站的访客画像：男女访客占比、年龄段分布、访客还常去的其他网站、最感兴趣的话题和内容分类，以及网站使用的技术栈、自然搜索和付费搜索的流量占比。它回答「谁在访问这个网站」，而不是「有多少人访问」，适合营销团队判断网站能否触达目标客群、规划投放与合作、了解竞品受众。

这些数字是 SimilarWeb 的估算，不是网站自己的统计，而且有滞后，存数前先看 `snapshot_date`。把 `organic_traffic_share` 和 `paid_traffic_share` 放在一起，能看出这个网站的搜索访客是靠 SEO 获得还是买来的。

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 待分析的网站域名，例如 example.com；即使 action 名为 search，也不是全网关键词搜索。search 返回流量概览，competitors 返回相似网站，audience 返回单站受众资料。指标是第三方估算，不等于该站 GA4 实测。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| male_share | 男性访客占比。 |
| female_share | 女性访客占比。 |
| age_distribution | 访客年龄段分布。 |
| top_interested_websites | 访客还常访问的其他站点。 |
| top_interested_topics | 访客最感兴趣的话题。 |
| top_interested_categories | 访客最感兴趣的内容分类。 |
| technologies | 该站使用的技术栈。 |
| organic_traffic_share | 自然搜索流量占比。 |
| paid_traffic_share | 付费搜索流量占比。与上一项对比可看出获客靠买还是靠 SEO。 |
| snapshot_date | 该份数据的统计快照日期。**流量数据有滞后，别当实时值。** |
| 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": "similarweb",
  "action": "audience",
  "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": "audience",
        "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. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "similarweb",
  "action": "audience",
  "results": {
    "id": "facebook.com",
    "url": "https://facebook.com",
    "name": "Facebook",
    "male_share": 0,
    "female_share": 0,
    "age_distribution": [
      {
        "min_age": 25,
        "max_age": 34,
        "share": 0
      },
      {
        "min_age": 35,
        "max_age": 44,
        "share": 0
      },
      {
        "min_age": 45,
        "max_age": 54,
        "share": 0
      }
    ],
    "top_interested_websites": [
      "instagram.com",
      "google.com",
      "youtube.com"
    ],
    "top_interested_topics": [
      "news",
      "shopping",
      "games"
    ],
    "top_interested_categories": [
      "games/video_games_consoles_and_accessories",
      "adult",
      "computers_electronics_and_technology/programming_and_developer_software"
    ],
    "technologies": [
      {
        "category": "payment_and_currencies",
        "top_tech": "Cart Functionality",
        "tech_count": 33
      },
      {
        "category": "advertising",
        "top_tech": "Google Adsense",
        "tech_count": 15
      },
      {
        "category": "audio_video_media",
        "top_tech": "YouTube",
        "tech_count": 6
      }
    ],
    "organic_traffic_share": 0,
    "paid_traffic_share": 0,
    "snapshot_date": "2026-08-01T00:00:00+00:00",
    "platform": "similarweb"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 这和 SimilarWeb 关键词搜索有什么区别？

SimilarWeb 关键词搜索虽然叫搜索，实际返回一个网站的流量概览：排名、估算访问量、跳出率等访问行为和流量来源。受众画像讲的是访问背后的人：性别、年龄、兴趣和常去的其他网站，再加上技术栈和搜索流量构成。两者都在 `keyword` 里填同一个域名。

### `male_share`、`female_share` 是实测的吗？

不是。和这里的其他数字一样，它们是 SimilarWeb 对访客构成的估算，不是网站自己的统计数据。适合在几个网站之间横向比较，读的时候结合 `age_distribution` 看受众结构，不要当成某个网站精确的用户构成。

### 数据是最新的吗？

不一定是当前值。`snapshot_date` 是这份数据的统计快照日期，流量类数据本身有滞后。定期跟踪一个网站时，每次把结果和 `snapshot_date` 一起存下，按快照日期比较前后变化，而不是按调用日期。

## 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
