Back to Details

similarweb-traffic

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SimilarWeb Traffic

SimilarWeb 流量数据

Fetch traffic-overview estimates for any domain — monthly visits, traffic-source breakdown, top countries, top keywords, engagement metrics, and global/category ranks.
获取任意域名的流量概览估算数据——月度访问量、流量来源细分、主要访问国家、热门关键词、用户参与度指标，以及全球/分类排名。

When to Use This Skill

何时使用此技能

Use this skill when the user:
  • Asks how much traffic a domain gets ("what's the traffic for X")
  • Wants monthly visit trends for a site
  • Needs a traffic-source breakdown (organic vs direct vs paid vs GenAI, etc.)
  • Wants to know a site's audience countries
  • Wants to compare/benchmark several domains against each other or competitors
当用户有以下需求时使用此技能：
  • 询问某域名的流量情况（如“X网站的流量是多少”）
  • 想要了解某网站的月度访问量趋势
  • 需要流量来源细分数据（自然搜索、直接访问、付费推广、生成式AI流量等）
  • 想知道某网站的受众所在国家
  • 想要对比/对标多个域名或竞品网站

Usage

使用方法

No API key required. Self-contained Node script (uses built-in 
fetch
, no 
npm install
).
bash
node scripts/fetch-similarweb-traffic.js <domain>
Examples:
bash
undefined
无需API密钥。这是一个独立的Node脚本（使用内置的
fetch
，无需执行
npm install
）。
bash
node scripts/fetch-similarweb-traffic.js <domain>
示例：
bash
undefined

Formatted markdown summary (default)

格式化Markdown摘要（默认模式）

node scripts/fetch-similarweb-traffic.js chatslide.ai
node scripts/fetch-similarweb-traffic.js chatslide.ai

Raw normalized JSON (for further processing / comparisons)

原始标准化JSON（用于后续处理/对比）

node scripts/fetch-similarweb-traffic.js stripe.com --json

The domain can be passed bare (`example.com`) or as a URL (`https://www.example.com/pricing`) — it gets normalized (strips scheme, `www.`, and path).
node scripts/fetch-similarweb-traffic.js stripe.com --json

域名可以直接传入（如`example.com`）或作为URL传入（如`https://www.example.com/pricing`）——脚本会自动标准化域名（移除协议、`www.`及路径部分）。

Comparing multiple domains

对比多个域名

Run the script once per domain with 
--json
and combine the results into a table. Add a short delay between calls to be polite to the endpoint.
对每个域名分别运行带
--json
参数的脚本，然后将结果合并为表格。为避免给服务器造成压力，请求之间请添加短暂延迟。

Output

输出结果

Default mode prints a markdown summary: a metrics table (monthly visits, ranks, bounce, pages/visit, time on site), a monthly-visits trend line, traffic-source breakdown, top countries, and top keywords.
--json
mode prints a normalized object:
json
{
  "domain": "stripe.com",
  "globalRank": 327,
  "categoryRank": 21,
  "category": "Finance",
  "snapshotMonth": "2026-05",
  "visits": 122394040,
  "bounceRate": 0.55,
  "pagesPerVisit": 3.26,
  "timeOnSite": 165.9,
  "estimatedMonthlyVisits": [{ "date": "2026-03-01", "visits": 118067753 }],
  "trafficSources": { "searchOrganic": 0.48, "direct": 0.23, "...": 0 },
  "topCountries": [{ "countryCode": "US", "value": 0.087 }],
  "topKeywords": ["..."]
}
visits
is the most recent complete month. Rates (
bounceRate
, all 
trafficSources
, 
topCountries[].value
) are 0–1 fractions.
默认模式会打印Markdown格式的摘要：包含指标表格（月度访问量、排名、跳出率、每次访问页数、网站停留时间）、月度访问量趋势线、流量来源细分、主要访问国家和热门关键词。
--json
模式会打印标准化的JSON对象：
json
{
  "domain": "stripe.com",
  "globalRank": 327,
  "categoryRank": 21,
  "category": "Finance",
  "snapshotMonth": "2026-05",
  "visits": 122394040,
  "bounceRate": 0.55,
  "pagesPerVisit": 3.26,
  "timeOnSite": 165.9,
  "estimatedMonthlyVisits": [{ "date": "2026-03-01", "visits": 118067753 }],
  "trafficSources": { "searchOrganic": 0.48, "direct": 0.23, "...": 0 },
  "topCountries": [{ "countryCode": "US", "value": 0.087 }],
  "topKeywords": ["..."]
}
visits
字段代表最近完整月份的访问量。比率类字段（
bounceRate
、所有
trafficSources
值、
topCountries[].value
）为0到1之间的小数。

API Details

API详情

  • Endpoint: 
    https://data.similarweb.com/api/v1/data?domain=<domain>
    — SimilarWeb's undocumented public data endpoint (the one their browser extension uses). No auth, no key, free.
  • Requires a browser 
    user-agent
    header (the script sends one) — default 
    curl
    /bot agents are blocked.
  • Synchronous, returns immediately.
  • 端点：
    https://data.similarweb.com/api/v1/data?domain=<domain>
    —— 这是SimilarWeb的未公开公共数据端点（其浏览器扩展所使用的端点）。无需授权，无需密钥，免费使用。
  • 需要浏览器
    user-agent
    请求头（脚本已内置该头）——默认的
    curl
    /机器人请求头会被拦截。
  • 同步请求，立即返回结果。

Important Notes

重要说明

  • Estimates, not ground truth. SimilarWeb models traffic; numbers can be off, especially for mid/low-traffic sites. For a domain you own, your own Google Analytics / Search Console data is authoritative — prefer those when available.
  • Unknown domains return zeros, not an error. SimilarWeb responds HTTP 200 with all-zero/synthetic data when it has no data for a domain. If every visit count is 0, treat it as "no SimilarWeb data."
  • Unofficial endpoint. It can be rate-limited, change shape, or require auth without notice; this is a gray-area use of SimilarWeb's data outside their paid API.
  • Exit codes: 
    2
    network error, 
    3
    non-200 HTTP response.
  • 仅为估算值，非真实数据。SimilarWeb通过模型计算流量数据；数据可能存在偏差，尤其是中低流量网站。对于你自己拥有的域名，建议优先使用Google Analytics或Search Console的权威数据。
  • 未知域名返回零值，而非错误。当SimilarWeb没有某域名的数据时，会返回HTTP 200状态码及全零/合成数据。如果所有访问量数值均为0，请视为“无SimilarWeb数据”。
  • 非官方端点。该端点可能会被限流、更改数据格式或突然要求授权；这属于在SimilarWeb付费API之外使用其数据的灰色地带。
  • 退出码：
    2
    表示网络错误，
    3
    表示非200 HTTP响应。