您需要可靠的网站流量统计数据，可以在本周内放入仪表板或丰富作业中。在本指南结束时，您将能够通过单个经过身份验证的HTTP GET请求请求任何域的流量指标（访问量、排名、来源等），并在几分钟内将其连接到您的代码中。
此API返回的内容及其用途
流量指标探索API为给定域提供高信号的网络分析：估计访问量、参与度（跳出率、每次访问页面数、网站停留时间）、全球/国家/类别排名、主要国家份额和流量来源组合。团队使用它来：
- 通过每月访问量估算和排名来丰富公司资料。
- 根据实际流量规模和增长模式优先考虑销售线索。
- 通过国家分布和获取渠道为竞争对手仪表板提供支持。
- 通过可证明的流量水平限制功能（例如，合作伙伴级别）。
它可以在 Zyla API Hub 上获得，提供一个帐户、一个API密钥和一个订阅模型，涵盖超过10,000个公共API。您可以一次订阅并跨类别调用，而无需 juggling 多个提供商。
在Zyla API Hub上开始
要获取API密钥：
- 打开API列表并开始试用： 开始7天试用流量指标探索API。
- 点击订阅（或在可用时开始免费试用）。您将收到一个用于所有Zyla API的单一API密钥。
- 通过HTTP头Authorization: Bearer YOUR_API_KEY使用该密钥。
Zyla的计费是订阅+配额，而不是按调用计费。没有免费计划；请查看API页面以获取当前访问选项和定价。
您将调用的端点
该API公开了一个流量指标的端点。它接受一个必需的参数，并返回一个包含访问和排名指标的结构化有效负载。
网站流量统计
- 方法：GET
- 网址：https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats
- 查询参数：
- domain（必需）：要分析的域（例如，gmail.com）。
- 身份验证：Authorization: Bearer YOUR_API_KEY
复制粘贴cURL请求
按原样运行此命令，将YOUR_API_KEY替换为您从Zyla获得的密钥。域参数是必需的。
curl -s -X GET "https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats?domain=gmail.com" \
-H "Authorization: Bearer YOUR_API_KEY"官方示例响应
以下是官方响应示例。使用它来映射您将在集成中读取的字段。
{"Version":1,"SiteName":"decorsystem.com.pl","Description":"sztukateria styropianowa wewnętrzna - produkujemy listwy dekoracyjne, listwy sufitowe, listwy ozdobne ścienne, przypodłogowe i inne elementy do wnętrz","TopCountryShares":[{"Country":616,"CountryCode":"PL","Value":0.9719507540741068},{"Country":276,"CountryCode":"DE","Value":0.011927008465685628},{"Country":826,"CountryCode":"GB","Value":0.010493205200990377},{"Country":528,"CountryCode":"NL","Value":0.005629032259217371}],"Title":"sztukateria ścienna, styropianowa, ozdobna, dekoracyjna","Engagments":{"BounceRate":"0.5099347930295581","Month":"11","Year":"2024","PagePerVisit":"3.527907956431343","Visits":"122728","TimeOnSite":"142.85020306566452"},"EstimatedMonthlyVisits":{"2024-09-01":133456,"2024-10-01":145713,"2024-11-01":122728},"GlobalRank":{"Rank":293452},"CountryRank":{"Country":616,"CountryCode":"PL","Rank":5641},"CategoryRank":{"Rank":"58","Category":"Home_and_Garden/Home_and_Garden"},"GlobalCategoryRank":null,"IsSmall":false,"Policy":0,"TrafficSources":{"Social":0.014974693477023336,"Paid Referrals":0.026707830225292793,"Mail":0.0038130298508330866,"Referrals":0.05137472542922812,"Search":0.41403432760255826,"Direct":0.4890953934014385},"Category":"home_and_garden/home_and_garden","LargeScreenshot":"https://site-images.similarcdn.com/image?url=decorsystem.com.pl&t=1&s=1&h=fd4f65c1308020880a5b57e8ad5b067e3df8691fc01c2428322ca684183216e4","IsDataFromGa":false,"Countries":[{"Code":"AF","UrlCode":"afghanistan","Name":"Afghanistan"},{"Code":"AX","UrlCode":"land-islands","Name":"Åland Islands"},{"Code":"AL","UrlCode":"albania","Name":"Albania"},{"Code":"DZ","UrlCode":"algeria","Name":"Algeria"},{"Code":"AS","UrlCode":"american-samoa","Name":"American Samoa"},{"Code":"AD","UrlCode":"andorra","Name":"Andorra"},{"Code":"AO","UrlCode":"angola","Name":"Angola"},{"Code":"AI","UrlCode":"anguilla","Name":"Anguilla"},{"Code":"AQ","UrlCode":"antarctica","Name":"Antarctica"},{"Code":"AG","UrlCode":"antigua-and-barbuda","Name":"Antigua and Barbuda"},{"Code":"AR","UrlCode":"argentina","Name":"Argentina"},{"Code":"AM","UrlCode":"armenia","Name":"Armenia"},{"Code":"AW","UrlCode":"aruba","Name":"Aruba"},{"Code":"AU","UrlCode":"australia","Name":"Australia"},{"Code":"AT","UrlCode":"austria","Name":"Austria"},{"Code":"AZ","UrlCode":"azerbaijan","Name":"Azerbaijan"},{"Code":"BS","UrlCode":"bahamas","Name":"Bahamas"},{"Code":"BH","UrlCode":"bahrain","Name":"Bahrain"},{"Code":"BD","UrlCode":"bangladesh","Name":"Ba…您可能会使用的关键字段：
- Engagments.Visits：当前月份的访问量（字符串数字）。视为整数计数。
- EstimatedMonthlyVisits：YYYY-MM-01到每月访问量估算的映射。对趋势线有用。
- GlobalRank.Rank，CountryRank.Rank：全球和特定国家的排名整数。
- TopCountryShares：具有流量份额的国家代码列表（0–1分数）。
- TrafficSources：渠道组合（分数总和约为1）。
- BounceRate，PagePerVisit，TimeOnSite：参与度指标。跳出率和其他值以字符串表示；解析为数字以进行计算。
Python示例：获取和规范核心指标
此脚本调用相同的端点，解析数字字符串，并打印紧凑的摘要。将YOUR_API_KEY替换为您的密钥，并设置您需要的域。
import os
import requests
API_KEY = os.getenv("Zyla_API_Key", "YOUR_API_KEY")
DOMAIN = "gmail.com"
url = "https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats"
params = {"domain": DOMAIN}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data = resp.json()
# Helper to coerce string numbers to float
def to_float(x):
try:
return float(x)
except Exception:
return None
# Extract core fields safely
site = data.get("SiteName")
desc = data.get("Description")
eng = data.get("Engagments", {})
visits = eng.get("Visits")
bounce = to_float(eng.get("BounceRate"))
ppv = to_float(eng.get("PagePerVisit"))
tos = to_float(eng.get("TimeOnSite")) # seconds
rank_global = (data.get("GlobalRank") or {}).get("Rank")
country_rank = (data.get("CountryRank") or {}).get("Rank")
country_code = (data.get("CountryRank") or {}).get("CountryCode")
sources = data.get("TrafficSources", {})
search_share = sources.get("Search")
direct_share = sources.get("Direct")
trend = data.get("EstimatedMonthlyVisits", {})
print({
"domain": DOMAIN,
"site": site,
"visits_current_month": int(visits) if isinstance(visits, str) and visits.isdigit() else visits,
"bounce_rate": bounce, # 0-1
"pages_per_visit": ppv,
"avg_time_on_site_sec": tos,
"global_rank": rank_global,
"country_rank": {"code": country_code, "rank": country_rank},
"traffic_sources": {"search": search_share, "direct": direct_share},
"estimated_monthly_visits": trend
})节省时间的实施技巧
- 身份验证：始终发送Authorization: Bearer YOUR_API_KEY。不要在查询字符串中传递API密钥。
- 数字解析：多个指标（例如，BounceRate，PagePerVisit，TimeOnSite，Visits）可能是字符串。在数学或排序之前强制转换为float/int。
- 单位：TimeOnSite是秒；TrafficSources和TopCountryShares是分数份额（0–1）。BounceRate是分数（0–1）。
- 趋势：EstimatedMonthlyVisits键是按月开始的ISO日期（YYYY-MM-01）。排序键并绘制，而不是假设连续顺序。
- 缓存：流量指标每月变化，具有增量更新；按域缓存响应以减少延迟和配额使用。
- 缺失字段：并非所有域都具有所有排名或丰富的元数据。始终对可选对象（如GlobalCategoryRank）进行空检查。
- 错误处理：处理非200响应和超时。重试和退避有助于批量丰富作业。
实际用例
潜在客户评分和路由
提取Engagments.Visits和GlobalRank以获取每个入站域，然后路由到正确的SDR级别。添加TrafficSources.Search以检测可能受益于内容合作的SEO驱动公司。
市场扩展规划
使用TopCountryShares计算竞争对手网站的前3个国家份额。将CountryRank输入热图，以突出强弱区域。
合作伙伴审查
在批准共同营销或附属请求之前，验证最低流量阈值和参与质量（PagePerVisit，BounceRate）。
内容策略
跟踪您的博客和竞争博客的EstimatedMonthlyVisits趋势。扁平化滚动3个月的平均值，并在≥15%的月度下降或增长时发出警报。
通过MCP从AI代理调用
如果您在Claude Code、Cursor、Windsurf或其他兼容MCP的客户端中工作，您可以通过将此API指向Zyla MCP端点将其连接到您的代理。相同的Authorization头和域参数适用；代理将代表您发出GET请求。
- MCP端点： MCP
- 只需传递您的Zyla密钥一次；然后您的代理可以使用该凭据调用流量指标探索API端点。
- 使用上面显示的相同URL和查询参数；代理通常允许您定义一个工具，该工具使用运行时提供的域执行GET。
逐字段映射备忘单
- SiteName、Title、Description：UI的标识符和可读标签。
- Engagments：
- Month、Year：表示当前聚合周期的字符串。
- Visits：当前月份的访问量估算。
- PagePerVisit、BounceRate、TimeOnSite：参与质量信号。
- EstimatedMonthlyVisits：按月开始日期键入的历史访问量，用于时间序列图表。
- GlobalRank、CountryRank、CategoryRank：用于比较小部件的排名上下文。
- TopCountryShares：用于地理混合饼图或目标逻辑的细分。
- TrafficSources：获取渠道；值为分数份额。
完整接线检查清单
- 在API列表上订阅并从 Zyla API Hub 获取您的密钥。
- 调用GET https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats，带上域和您的Authorization头。
- 将数字字符串解析为数字，存储原始JSON以便审计。
- 按域缓存24小时（或您的SLA窗口），以最小化重复获取。
- 构建UI组件：
- 标题：访问量（当前月份）、全球排名。
- 趋势：EstimatedMonthlyVisits火花线。
- 细分：TopCountryShares和TrafficSources饼图。
- 质量：BounceRate、PagePerVisit、TimeOnSite徽章。
常见问题
需要什么身份验证？
在每个请求的头中发送Authorization: Bearer YOUR_API_KEY。
哪些参数是必需的？
该端点需要一个查询参数：domain。示例：?domain=gmail.com。
指标更新的频率是多少？
流量和排名是每月汇总的，定期刷新。对于大多数应用程序，每个域的每日或每周缓存就足够了。
我可以获取历史数据吗？
是的，通过EstimatedMonthlyVisits对象，该对象将月份开始日期（YYYY-MM-01）映射到访问计数。
有免费计划吗？
没有免费计划。项目页面上提供7天试用；请查看列表以获取当前访问选项和定价。
准备好发布了吗？开始您的7天试用，获取您的API密钥，并立即将流量指标插入您的产品： 开始7天试用流量指标探索API。
官方API响应
{"Version":1,"SiteName":"decorsystem.com.pl","Description":"sztukateria styropianowa wewnętrzna - produkujemy listwy dekoracyjne, listwy sufitowe, listwy ozdobne ścienne, przypodłogowe i inne elementy do wnętrz","TopCountryShares":[{"Country":616,"CountryCode":"PL","Value":0.9719507540741068},{"Country":276,"CountryCode":"DE","Value":0.011927008465685628},{"Country":826,"CountryCode":"GB","Value":0.010493205200990377},{"Country":528,"CountryCode":"NL","Value":0.005629032259217371}],"Title":"sztukateria ścienna, styropianowa, ozdobna, dekoracyjna","Engagments":{"BounceRate":"0.5099347930295581","Month":"11","Year":"2024","PagePerVisit":"3.527907956431343","Visits":"122728","TimeOnSite":"142.85020306566452"},"EstimatedMonthlyVisits":{"2024-09-01":133456,"2024-10-01":145713,"2024-11-01":122728},"GlobalRank":{"Rank":293452},"CountryRank":{"Country":616,"CountryCode":"PL","Rank":5641},"CategoryRank":{"Rank":"58","Category":"Home_and_Garden/Home_and_Garden"},"GlobalCategoryRank":null,"IsSmall":false,"Policy":0,"TrafficSources":{"Social":0.014974693477023336,"Paid Referrals":0.026707830225292793,"Mail":0.0038130298508330866,"Referrals":0.05137472542922812,"Search":0.41403432760255826,"Direct":0.4890953934014385},"Category":"home_and_garden/home_and_garden","LargeScreenshot":"https://site-images.similarcdn.com/image?url=decorsystem.com.pl&t=1&s=1&h=fd4f65c1308020880a5b57e8ad5b067e3df8691fc01c2428322ca684183216e4","IsDataFromGa":false,"Countries":[{"Code":"AF","UrlCode":"afghanistan","Name":"Afghanistan"},{"Code":"AX","UrlCode":"land-islands","Name":"Åland Islands"},{"Code":"AL","UrlCode":"albania","Name":"Albania"},{"Code":"DZ","UrlCode":"algeria","Name":"Algeria"},{"Code":"AS","UrlCode":"american-samoa","Name":"American Samoa"},{"Code":"AD","UrlCode":"andorra","Name":"Andorra"},{"Code":"AO","UrlCode":"angola","Name":"Angola"},{"Code":"AI","UrlCode":"anguilla","Name":"Anguilla"},{"Code":"AQ","UrlCode":"antarctica","Name":"Antarctica"},{"Code":"AG","UrlCode":"antigua-and-barbuda","Name":"Antigua and Barbuda"},{"Code":"AR","UrlCode":"argentina","Name":"Argentina"},{"Code":"AM","UrlCode":"armenia","Name":"Armenia"},{"Code":"AW","UrlCode":"aruba","Name":"Aruba"},{"Code":"AU","UrlCode":"australia","Name":"Australia"},{"Code":"AT","UrlCode":"austria","Name":"Austria"},{"Code":"AZ","UrlCode":"azerbaijan","Name":"Azerbaijan"},{"Code":"BS","UrlCode":"bahamas","Name":"Bahamas"},{"Code":"BH","UrlCode":"bahrain","Name":"Bahrain"},{"Code":"BD","UrlCode":"bangladesh","Name":"Ba…官方API响应
{"Version":1,"SiteName":"decorsystem.com.pl","Description":"sztukateria styropianowa wewnętrzna - produkujemy listwy dekoracyjne, listwy sufitowe, listwy ozdobne ścienne, przypodłogowe i inne elementy do wnętrz","TopCountryShares":[{"Country":616,"CountryCode":"PL","Value":0.9719507540741068},{"Country":276,"CountryCode":"DE","Value":0.011927008465685628},{"Country":826,"CountryCode":"GB","Value":0.010493205200990377},{"Country":528,"CountryCode":"NL","Value":0.005629032259217371}],"Title":"sztukateria ścienna, styropianowa, ozdobna, dekoracyjna","Engagments":{"BounceRate":"0.5099347930295581","Month":"11","Year":"2024","PagePerVisit":"3.527907956431343","Visits":"122728","TimeOnSite":"142.85020306566452"},"EstimatedMonthlyVisits":{"2024-09-01":133456,"2024-10-01":145713,"2024-11-01":122728},"GlobalRank":{"Rank":293452},"CountryRank":{"Country":616,"CountryCode":"PL","Rank":5641},"CategoryRank":{"Rank":"58","Category":"Home_and_Garden/Home_and_Garden"},"GlobalCategoryRank":null,"IsSmall":false,"Policy":0,"TrafficSources":{"Social":0.014974693477023336,"Paid Referrals":0.026707830225292793,"Mail":0.0038130298508330866,"Referrals":0.05137472542922812,"Search":0.41403432760255826,"Direct":0.4890953934014385},"Category":"home_and_garden/home_and_garden","LargeScreenshot":"https://site-images.similarcdn.com/image?url=decorsystem.com.pl&t=1&s=1&h=fd4f65c1308020880a5b57e8ad5b067e3df8691fc01c2428322ca684183216e4","IsDataFromGa":false,"Countries":[{"Code":"AF","UrlCode":"afghanistan","Name":"Afghanistan"},{"Code":"AX","UrlCode":"land-islands","Name":"Åland Islands"},{"Code":"AL","UrlCode":"albania","Name":"Albania"},{"Code":"DZ","UrlCode":"algeria","Name":"Algeria"},{"Code":"AS","UrlCode":"american-samoa","Name":"American Samoa"},{"Code":"AD","UrlCode":"andorra","Name":"Andorra"},{"Code":"AO","UrlCode":"angola","Name":"Angola"},{"Code":"AI","UrlCode":"anguilla","Name":"Anguilla"},{"Code":"AQ","UrlCode":"antarctica","Name":"Antarctica"},{"Code":"AG","UrlCode":"antigua-and-barbuda","Name":"Antigua and Barbuda"},{"Code":"AR","UrlCode":"argentina","Name":"Argentina"},{"Code":"AM","UrlCode":"armenia","Name":"Armenia"},{"Code":"AW","UrlCode":"aruba","Name":"Aruba"},{"Code":"AU","UrlCode":"australia","Name":"Australia"},{"Code":"AT","UrlCode":"austria","Name":"Austria"},{"Code":"AZ","UrlCode":"azerbaijan","Name":"Azerbaijan"},{"Code":"BS","UrlCode":"bahamas","Name":"Bahamas"},{"Code":"BH","UrlCode":"bahrain","Name":"Bahrain"},{"Code":"BD","UrlCode":"bangladesh","Name":"Ba…
