跳到主要内容
本页目录

免费查网站 API

用一把 API 钥匙读取网站流量、注册信息和网站数据,免费版和 Pro 都能用。

积分、套餐与鉴权
  • 查一个域名扣 1 积分;批量和后缀对比每个域名 1 积分。
  • 免费版每月 100 积分,Pro 每月 10,000 积分,按 UTC 每月重置。
  • 关键词查询和关键词排名(include=search)属于 Pro。
  • 在 API 控制台生成 vf_live_ 钥匙,放进 Authorization: Bearer 请求头。
  • 网站、公开广告与发布商研究工具在早期免费,响应里 credits_spent 为 0。

/api/v1Authorization: Bearer vf_live_…v1.4.0

请求

curl -sS "https://vaneform.com/api/v1/domains/example.com?include=scale,registry" \
  -H "Authorization: Bearer $VANEFORM_API_KEY"

Authorization: Bearer $VANEFORM_API_KEY 钥匙放在服务端环境变量里。

示例
{
  "domain": "example.com",
  "status": "ready",
  "refresh_policy": "cache_only",
  "scale": {
    "status": "ready",
    "estimate": "site",
    "visits": 7560000,
    "visits_mom_change_pct": 15.06,
    "as_of": "2026-08-31",
    "confidence": "medium"
  },
  "registry": {
    "status": "ready",
    "created_at": "1995-08-14T04:00:00.000Z",
    "registrar": "RESERVED-Internet Assigned Numbers Authority"
  },
  "report_url": "https://vaneform.com/e/example-com"
}

上面是 include=scale,registry 的一种返回。没有值的字段会省略。访问量估计带 as_of 和 confidence。scale.estimate 为 site 或 search。域名和每一组都使用下面的 status。

status说明
ready有可用数据
partial只有一部分字段
missing没有已保存的结果
error这一组读取失败

扣积分

调用积分何时扣
读域名,include 不含 search1取得新的可用域名结果时扣积分。24 小时内重复读取扣 0。
include 含 search200仅 Pro。域名 status 为 ready 或 partial,且没有已保存的排名,或那份排名的 status 为 ready。这两种情况响应里都可能出现 search.status 为 missing。已保存排名的 status 为 missing、error 或 partial 时扣 0。
查一个关键词60仅 Pro。缓存未命中,且这次 status 为 ready。缓存 status 已是 ready 或 empty 时扣 0。
批量或后缀里的每个域名1每个有数据的域名扣积分。24 小时内重复扣 0。受单次域名上限限制。
账号0每次
套餐每月积分单次比较域名关键词数据
免费版1003—
Pro10,00030可用

每把钥匙每分钟 60 次、每天 5000 次,超出返回 429 lookup_rate_exceeded 和 Retry-After。

缓存、回执与余额规则
缓存
域名读取的 refresh_policy 为 cache_only,只返回已保存的结果。baidu 和 include=search 也只读已保存的结果。批量和后缀在这个域名还没有可用的月访问时会补读访问量,注册信息需要更新时会补读注册信息。比较的响应里没有 refresh_policy。
回执
include=search 对同一账号、同一域名保留 24 小时回执,再读扣 0。关键词的扣积分见上面一行。
余额
返回正文前会先确认余额够本次扣积分:查域名 1 积分,include=search 200 积分,关键词缓存未命中 60 积分。余额不够时返回 credits_exhausted,这次扣 0。
lookup
lookup 是网页查网站的每日次数。limit 为 null 时没有每日上限。API 钥匙另行限速。

域名

GET/api/v1/domains/{domain}

读取一个域名已保存的访问量、注册信息、网站概况和外链。

参数说明
domain必填域名,例如 example.com。去掉开头的 www.,主机名转为小写。回执按这个主机名计算。
include可选逗号分隔。默认 scale,registry,profile,popularity。写入 baidu 或 search 才返回那两组。无法识别的名字返回 invalid_request。
include何时返回字段
scale默认visits 是月访问估计。visits_mom_change_pct 是环比,单位是百分比。as_of 是数据日期。confidence 为 low、medium、high。estimate 为 site 或 search。global_rank 是整数。country_rank 含 country、rank。top_regions 含 country、share。这两处的 country 是英文国名,例如 United States。monthly_visits 含 month、visits,month 形如 2026-08。bounce_rate、sources 的值和 top_regions.share 是 0 到 1。sources 里出现的键来自 direct、search、social、referrals、mail、display_ads、search_paid、gen_ai、other。还有 pages_per_visit、time_on_site_seconds。top_keywords 的每一项含 keyword、search_volume_monthly、estimated_visits。
registry默认created_at、expires_at、updated_at、registrar、name_servers、statuses、dnssec、age_days、as_of。name_servers、statuses 为字符串数组。dnssec 为 true 或 false。
profile默认title、description、final_url、http_status、lang。dns 的 a、aaaa、mx、ns 是字符串数组。email_auth 里 spf、dmarc、mta_sts、bimi、dkim 为 true 或 false,dmarc_policy 是策略名。hosting 含 asn、name、country、prefix。tls 含 issuer、protocol、valid_to、days_remaining。
popularity默认link_rank 是外链排名。还有 tld、tld_rank、referring_ips、referring_subnets、rank_change、board_rank、as_of、confidence。board_rank 是榜单名次。
baidu写入 include只读已保存的百度权重。status 为 missing 或 error 时返回 status、as_of、confidence。其余状态返回 keyword_count、estimated_visits.min、estimated_visits.max、as_of、confidence。weights 里出现的键来自 baidu_pc、baidu_mobile、q360_pc、sogou_pc、toutiao、bing_pc、google。
search写入 include,Pro只读已保存的结果:这个网站排了哪些词、落在哪些页、搜索里的竞品。include_subdomains 为 false,范围是查询的主机。organic_etv 是自然搜索访问估计。keyword_count、page_count、competitor_count 是总数,可以大于对应数组的长度。keywords 最多 25 条,含 keyword、position、search_volume_monthly、estimated_visits、url;role 为 brand 或 other;有名次变化时 change 为 new、up 或 down;出现在 AI 概览时 ai 为 true;论坛地址带 thread。pages 最多 20 条。论坛地址留在 keywords。每条含 url、keyword_count、estimated_visits。pages[].keyword_count 是这份关键词样本里落到该页的条数。competitors 最多 20 条,含 domain、keyword_count、estimated_visits、avg_position。competitors_pending 为 true 时,竞品还没写入缓存。还有 as_of、confidence、ai_overview_count、new_count、up_count、down_count。

按组读取

每个路径仍返回 domain、status、refresh_policy,有报告时还有 report_url。其余字段只有路径上的那一组。/search 需要 Pro。

  • /api/v1/domains/{domain}/scale
  • /api/v1/domains/{domain}/registry
  • /api/v1/domains/{domain}/profile
  • /api/v1/domains/{domain}/popularity
  • /api/v1/domains/{domain}/baidu
  • /api/v1/domains/{domain}/search

关键词

Pro

GET/api/v1/keyword?q=

查一个词的月搜索量、点击价格和难度,并返回美国英语 Google 的自然结果。结果最多 30 条。market.id 固定为 us。market.label 是展示名。status 为 ready、empty、missing 或 error。empty 表示没有结果行。

参数说明
q必填去掉首尾空白后长于 200 个字符时返回 invalid_request。查询会转成小写、合并连续空格,并按前 80 个字符读取。响应里的 keyword 是规范化之后的词。
字段说明
search_volume_monthly月搜索量
cpc_usd点击价格,美元。同级还有 cpc_low_usd、cpc_high_usd。
keyword_difficulty难度
search_intentinformational、navigational、commercial、transactional。
paid_competitionLOW、MEDIUM 或 HIGH。
volume_trendmonthly、quarterly、yearly 是百分比。值为 0 时省略该字段。
monthly_searches最近最多 12 个月,每项含 month、volume。month 形如 2026-08。
items[].positionGoogle 结果名次
items[].domain结果域名
items[].url结果 URL
items[].title / description结果标题和摘要。没有则省略。
items[].scale该结果域名已保存的访问量,字段和域名接口的 scale 相同。
items[].report_url该结果在本站的报告地址。没有则省略。
示例
{
  "keyword": "website traffic",
  "market": { "id": "us" },
  "status": "ready",
  "as_of": "2026-09-01",
  "search_volume_monthly": 12100,
  "cpc_usd": 2.4,
  "keyword_difficulty": 46,
  "search_intent": "informational",
  "items": [
    {
      "position": 1,
      "domain": "example.com",
      "url": "https://example.com/",
      "scale": { "visits": 7560000, "estimate": "site" }
    }
  ]
}

比较

GET/api/v1/bulk?q=

一次读取多个域名的访问量和注册信息。

参数说明
q必填逗号或换行分隔的域名,例如 example.com,iana.org。重复域名只保留一个。无法解析的域名会跳过。一个都解析不了,或个数超过本套餐单次上限时,返回 invalid_request。响应里的 q 是这些域名,已去重、去掉 www.、转成小写,用逗号连接。

GET/api/v1/tld?q=&s=

比较同一个可注册名字的不同后缀。默认后缀是 com, ai, io。

参数说明
q必填可注册的基础名,例如 example。写名字本身,后缀放到 s。example.com 会按 example 读取。响应里的 q 是这个小写基础名。
s可选逗号或空白分隔的后缀。省略,或一个都无法解析时,使用 com, ai, io。混在列表里、无法解析的后缀会跳过,重复的只保留一个。超过本套餐单次上限的后缀会被截掉。响应里的 suffixes 和 items 按站内后缀表排列,和请求中的书写顺序不同。按返回的 suffixes 对齐。
字段说明
items[].title网站标题
items[].scale.status该域名访问量的 status。
items[].scale.visits月访问估计
items[].scale.visits_mom_change_pct环比,单位是百分比
items[].registry.status该域名注册信息的 status。
items[].registry.created_at注册时间
items[].registry.expires_at到期时间
items[].report_url网页报告地址
suffixes仅后缀比较返回。默认 com, ai, io。
countitems 的个数

下面是 /api/v1/tld?q=example&s=com 的返回。省略 s 时后缀为 com, ai, io。count 等于 items 的个数。批量响应没有 suffixes。

示例
{
  "q": "example",
  "suffixes": ["com"],
  "count": 1,
  "items": [
    {
      "domain": "example.com",
      "title": "Example Domain",
      "scale": {
        "status": "ready",
        "visits": 7560000,
        "visits_mom_change_pct": 15.06
      },
      "registry": {
        "status": "ready",
        "created_at": "1995-08-14T04:00:00.000Z",
        "expires_at": "2026-08-13T04:00:00.000Z"
      },
      "report_url": "https://vaneform.com/e/example-com"
    }
  ]
}

账号

GET/api/v1/account

读取套餐、网页查网站次数和积分。这次调用扣 0。批量之前看 credits.remaining 和 credits.resets_at。

示例
{
  "plan": "pro",
  "access_tier": "pro",
  "lookup": {
    "used": 4,
    "limit": null,
    "remaining": null,
    "resets_at": "2026-09-30T00:00:00.000Z"
  },
  "credits": {
    "used": 260,
    "limit": 10000,
    "remaining": 9740,
    "resets_at": "2026-10-01T00:00:00.000Z",
    "top_up_remaining": 0
  }
}
字段说明
planfree 或 pro
access_tierfree 或 pro,取值和 plan 相同。
lookup.used当天已经使用的网页查网站次数
lookup.limit网页查网站的每日上限。null 表示没有每日上限
lookup.remaining今日剩余次数。limit 为 null 时,这里也是 null
lookup.resets_at每日次数的重置时间
credits.used本月已用的套餐积分
credits.limit本月套餐包含的积分
credits.remaining当前可用积分,含充值余额
credits.resets_at下个 UTC 月的开始
credits.top_up_remaining充值余额

错误

失败响应的正文是 error.code、error.message、error.status、error.request_id、error.docs_url。error.message 为英文。429 的响应头带 Retry-After。

示例
{
  "error": {
    "code": "credits_exhausted",
    "message": "Credits are used up for this billing period.",
    "status": 429,
    "request_id": "req_…",
    "docs_url": "https://vaneform.com/docs/api#error-credits_exhausted"
  }
}
HTTPcode说明
400invalid_requestinclude、q 或其他参数无法解析。
400invalid_domain域名缺失,或无法作为公开可注册域名使用。
401unauthorized请求里没有 Authorization: Bearer 钥匙,请求头格式不对,或查询参数里带了 api_key、key。
401invalid_api_key钥匙无效,或已经更换。
429lookup_limit_exceeded当天的网页查网站次数已经用完。
429credits_exhausted余额不够这次积分。响应是错误,这次不扣积分。重置时间看 credits.resets_at。
429lookup_rate_exceeded这把钥匙请求过多(每分钟 60 次或每天 5000 次)。响应头 Retry-After 是需要等待的秒数。
403search_requires_proinclude=search 属于 Pro,响应里带 upgrade_url。
403pro_required关键词数据属于 Pro,响应里带 upgrade_url。
404not_found路径不存在。
405method_not_allowedPOST 返回这个码。
500internal_error服务端没有完成这次请求。

免费研究工具

网站概况、广告、发布商和外链研究,早期免费。

覆盖范围、查询与工作区接口
  • 查询网站概况、Google 与 Meta 广告、发布商关联、出站链接、广告文案、已有网站机会和 DR 日期变化。广告文案与发布商反查覆盖已收录集合;结果保留观察时间、可信度和数据范围。
  • GET /api/tools/query 读取已存数据,POST 可以获取公开来源。查询支持匿名使用;带上 Bearer 钥匙后,会记录私人查询历史。
  • GET /api/tools/workspace 读取保存、历史、监控和变化提醒。POST 支持 save、monitor、remove_save、update_monitor、remove_monitor、check_monitor 和 read_event。私人操作均需 Bearer 钥匙;条目 ID 来自工作区响应,监控周期为 1 或 7 天。
curl -X POST 'https://vaneform.com/api/tools/query' \
  -H 'Content-Type: application/json' \
  --data '{"tool":"google-ads","q":"example.com","limit":40}'

打开研究工具

HTTP 和 MCP 用同一把钥匙。客户端不带钥匙也能列出 MCP 工具,调用工具时需要钥匙。把配置贴进客户端,并把 vf_live_… 换成你的钥匙。

五个研究工具

五个免费 MCP 工具承接同一研究流程:research_site 查询公开数据,get_research_workspace 读取私人研究,save_research 保存文件夹和备注,monitor_research 创建日周监控,manage_research 暂停、恢复、调整频率、立即检查、移除目标或标记提醒已读。

https://vaneform.com/mcp

{
  "mcpServers": {
    "vaneform": {
      "url": "https://vaneform.com/mcp",
      "headers": {
        "Authorization": "Bearer vf_live_…"
      }
    }
  }
}

SKILL.md 写了工具名、参数和字段。 打开 SKILL.md

开源(MIT):本地 stdio MCP 服务器、命令行和 Agent Skill。 GitHub 上的 vaneform-mcp

示例:一次查询,扣 1 积分

对 example.com 发起 include=scale,registry 请求,会返回带 as_of 月份和可信度的访问估计以及注册日期,扣 1 积分。免费版和 Pro 都能用 API;每把钥匙每分钟 60 次、每天 5,000 次。

常见问题

查网站 API 包含什么?

免费版和 Pro 都能用 API。查网站(访问估计、注册信息和网站数据)每次 1 积分,批量和后缀对比每个域名 1 积分。免费版每月 100 积分,Pro 每月 10,000 积分。关键词查询(60 积分)和 include=search(200 积分)属于 Pro。

API 返回的流量是估计值吗?

是的。每个访问数字都带 as_of 和 confidence,scale.estimate 说明它是全站估计还是搜索估计。

AI 智能体能用这个 API 吗?

可以。同一把钥匙可用于 HTTP 和 MCP 端点,OpenAPI 文档和 SKILL.md 列出所有工具和字段。