流量来源和概述的API

您需要可靠的流量来源和参与数据用于一个域名，并且您需要在本周内完成。通过本文，您将确切知道哪个端点返回流量来源和概述指标，如何调用它，如何解析您关心的字段，以及如何通过MCP从AI代理运行相同的调用——使用来自Zyla API Hub的一个API密钥。

此API提供的内容及使用时机

Zyla API Hub上的网站流量API返回域级别的网络流量智能：按流量份额排名的前五个国家、参与指标，以及包含网站标题和描述的概述。一个配套的端点提供支持的国家和ISO代码，当您想将数字或字母国家代码映射为可读标签时非常有用。

典型用途：

• 需要前五个国家份额和参与指标的市场归因仪表板。
• 基于域名流量模式和每月访问估算的销售线索评分。
• 注释域名的内容或SEO工具，提供流量上下文和基本元数据。

所有操作都在一个Zyla账户和一个API密钥下进行；您可以使用相同的密钥和订阅+配额模型从Zyla API Hub目录中调用任何API（10,000+ APIs）。

在Zyla API Hub上开始

打开Zyla上的网站流量API页面，点击订阅或开始7天试用，并获取您的API密钥。身份验证是作为Authorization: Bearer YOUR_API_KEY发送的承载令牌。计费是订阅+配额（不是按调用计费）。对于第一个API，预计有7天的试用或50个请求；请查看API页面以获取当前访问选项和定价。

从这里开始：在网站流量API上开始7天试用。您可以随时在Zyla API Hub主页上探索更多API。

您将使用的端点

1) 流量来源和概述

方法：GET

URL：https://zylalabs.com/api/29/site-traffic-api/93/traffic-source-and-overview

返回内容：按国家的流量状态（前5名）、流量来源上下文和给定域的参与信息。传递不带协议或“www”的域名。

• 必需的查询参数：域名（示例：google.com）

官方cURL：

curl -s -X GET "https://zylalabs.com/api/29/site-traffic-api/1372/countries-list" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例响应：

{
"Version": 1,
"SiteName": "google.com",
"Description": "了解认证发布者计划。我们的出版软件专家将帮助您最大化收入并发展您的业务。",
"TopCountryShares": [
{
"Country": 840,
"CountryCode": "US",
"Value": 0.23679350972974017
},
{
"Country": 392,
"CountryCode": "JP",
"Value": 0.059428140900848324
},
{
"Country": 356,
"CountryCode": "IN",
"Value": 0.05710248670449797
},
{
"Country": 76,
"CountryCode": "BR",
"Value": 0.049777326688909565
},
{
"Country": 826,
"CountryCode": "GB",
"Value": 0.03518837304351638
}
],
"Title": "Google高级搜索",
"Engagments": {
"BounceRate": "0.28352824215831807",
"Month": "6",
"Year": "2026",
"PagePerVisit": "8.695346223748027",
"Visits": "84940150026",
"TimeOnSite": "605.4395199614316"
},
"EstimatedMonthlyVisits": {
"2026-04-01": 84751050692,…

需要注意的字段：

• SiteName、Title、Description：您可以在UI中显示的快速元数据。
• TopCountryShares：按流量份额排名的前五个国家。包括数字国家、两字母国家代码和分数值（份额）。
• Engagments：有效负载中按月和年提供的参与指标，包括BounceRate、PagePerVisit、Visits和TimeOnSite。
• EstimatedMonthlyVisits：日期键（YYYY-MM-01）及访问总数。

2) 国家列表

方法：GET

URL：https://zylalabs.com/api/29/site-traffic-api/1372/countries-list

返回内容：支持的国家和代码列表。用于将流量概述返回的Country和CountryCode值映射为显示友好的名称和地区。

官方cURL：

官方示例响应：

[{"name":"Afghanistan","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"Asia","sub-region":"Southern Asia","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"Åland Islands","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"Europe","sub-region":"Northern Europe","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"Albania","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Algeria","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"Africa","sub-region":"Northern Africa","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"American Samoa","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"Oceania","sub-region":"Polynesia","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"Andorra","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Angola","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"Africa","sub-region":"Sub-Saharan Africa","intermediate-region":"Middle Africa","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"Anguilla","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"Americas","sub-region":"Latin America and the Caribbean","intermediate-region":"Caribbean","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"Antarctica","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"安提瓜和巴布达","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"美洲","sub-region":"拉丁美洲和加勒比","intermediate-region":"加勒比","region-code":"019","s…

常见用法：构建一个以alpha-2或国家代码为键的本地缓存，以丰富来自流量概述的TopCountryShares行的国家名称和地区。

端到端示例：获取域的流量概述并映射国家

以下是一个最小的Python示例：

1. 调用流量来源和概述端点，传入域名。
2. 调用国家列表端点一次，并通过alpha-2代码构建查找表。
3. 打印带有可读国家名称和份额的前五个国家表。

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
BASE = "https://zylalabs.com/api/29/site-traffic-api"

def get_overview(domain: str):
url = f"{BASE}/93/traffic-source-and-overview"
resp = requests.get(url, params={"domain": domain}, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
return resp.json()

def get_countries():
url = f"{BASE}/1372/countries-list"
resp = requests.get(url, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
return resp.json()

def build_country_lookup(countries):
# 将alpha-2代码映射到国家名称（例如，“US” -> “美国”）
lookup = {}
for c in countries:
alpha2 = c.get("alpha-2")
name = c.get("name")
if alpha2 and name:
lookup[alpha2] = name
return lookup

if __name__ == "__main__":
domain = "google.com"
overview = get_overview(domain)
countries = get_countries()
code_to_name = build_country_lookup(countries)

print(f"网站: {overview.get('SiteName')}")
print(f"标题: {overview.get('Title')}")
print(f"描述: {overview.get('Description')}")

print("\n按份额排名的前5个国家:")
for row in overview.get("TopCountryShares", []):
code = row.get("CountryCode")
share = row.get("Value")
name = code_to_name.get(code, code)
print(f"- {name} ({code}): {share}")

engagements = overview.get("Engagments", {})
print("\n参与:")
for k in ["Year", "Month", "Visits", "BounceRate", "PagePerVisit", "TimeOnSite"]:
if k in engagements:
print(f"{k}: {engagements[k]}")

注意事项：

• 授权通过头部Authorization: Bearer YOUR_API_KEY进行。
• 这些GET端点不需要请求体。
• 考虑将国家列表缓存24小时或更长时间；它变化不频繁并加快您的流程。

节省时间的实际实施细节

• 域名格式：仅传递域名，不带协议或“www”（例如，example.com）。
• 数据类型：几个数值（例如，BounceRate、PagePerVisit）以字符串形式到达；根据需要在您的应用逻辑中解析。
• 流量份额：TopCountryShares.Value是一个分数份额（例如，0.23 = 23%）。在UI中乘以100以获得百分比。
• 国家映射：使用CountryCode（alpha-2）与国家列表结合，以渲染显示名称而不进行硬编码。
• 缓存：建议对EstimatedMonthlyVisits和国家列表进行缓存，以减少延迟并保持在您的订阅配额内。
• 错误：通过向用户显示清晰的消息来处理非2xx代码（无效域、缺少授权头等）。

现实世界的用例

CRM中的线索丰富

当新的线索包含一个网站时，调用流量来源和概述端点以获取TopCountryShares并显示该线索受众的主要市场。结合来自Engagments的Visits和PagePerVisit来优先考虑外展。

归因仪表板

对于您跟踪的每个域（例如，推荐或合作伙伴），提取并缓存按月键入的EstimatedMonthlyVisits。使用TopCountryShares按地理位置分解贡献，以堆叠条形图或分级地图显示。

SEO和内容规划

丰富SERP结果或竞争对手列表，提供标题和描述以快速概述，并显示BounceRate或PagePerVisit以突出内容改进的机会。

从AI代理（MCP）调用API

如果您通过Claude Code、Cursor、Windsurf或任何兼容MCP的客户端进行自动化，您可以通过Zyla的MCP网关路由调用。配置您的工具以使用MCP端点并提供您的API密钥：

MCP

在运行时，您的代理可以针对上述相同的Hub URL（包括流量来源和概述端点的查询参数域名）进行目标设置。保持Authorization头为Bearer YOUR_API_KEY，或遵循您的MCP客户端的配置以传递凭据。由于您处于订阅+配额计划中，请设计提示以重用缓存结果，而不是在每次调用网络时重新调用。

发货前的验证清单

• 经过身份验证的GET请求，带有Authorization: Bearer YOUR_API_KEY。
• 对于概述：包括域名查询参数，不带协议和www。
• 解析JSON并在需要时转换字符串化的数值字段。
• 将TopCountryShares.CountryCode映射到通过国家列表获得的可读名称。
• 缓存国家列表和每月估算，以保持在配额内并改善延迟。

常见问题解答

API是否接受完整的URL还是仅接受域名？
仅应传递不带协议和“www”的域名（例如，example.com）到流量来源和概述端点。

我如何进行身份验证？
在每个请求的头部发送Authorization: Bearer YOUR_API_KEY。

我可以获得支持的国家列表吗？
可以。调用国家列表端点以接收支持的国家和ISO代码，您可以用来丰富来自概述端点的TopCountryShares。

数值字段是数字还是字符串？
Engagments对象中的某些指标（例如，BounceRate、PagePerVisit、Visits、TimeOnSite）以字符串形式返回。如果您需要计算或格式化它们，请在代码中将其解析为数字。

限制和定价是什么？
Zyla使用订阅+配额模型（不是按调用计费）。对于第一个API，预计有7天的试用或50个请求。请查看API页面以获取当前访问选项和定价。

准备好实施了吗？获取您的密钥并立即开始提取流量来源和参与数据：在网站流量API上开始7天试用。当您准备扩展集成时，请在Zyla API Hub上探索更多类别。

官方API响应

[{"name":"阿富汗","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"亚洲","sub-region":"南亚","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"奥兰群岛","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"欧洲","sub-region":"北欧","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"阿尔巴尼亚","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"欧洲","sub-region":"南欧","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"阿尔及利亚","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"非洲","sub-region":"北非","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"美属萨摩亚","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"大洋洲","sub-region":"波利尼西亚","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"安道尔","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"欧洲","sub-region":"南欧","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"安哥拉","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"非洲","sub-region":"撒哈拉以南非洲","intermediate-region":"中非","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"安圭拉","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"美洲","sub-region":"拉丁美洲和加勒比","intermediate-region":"加勒比","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"南极洲","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"安提瓜和巴布达","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"美洲","sub-region":"拉丁美洲和加勒比","intermediate-region":"加勒比","region-code":"019","s…

官方API响应

[{"name":"阿富汗","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"亚洲","sub-region":"南亚","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"奥兰群岛","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"欧洲","sub-region":"北欧","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"阿尔巴尼亚","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"欧洲","sub-region":"南欧","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"阿尔及利亚","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"非洲","sub-region":"北非","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"美属萨摩亚","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"大洋洲","sub-region":"波利尼西亚","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"安道尔","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"欧洲","sub-region":"南欧","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"安哥拉","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"非洲","sub-region":"撒哈拉以南非洲","intermediate-region":"中非","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"安圭拉","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"美洲","sub-region":"拉丁美洲和加勒比","intermediate-region":"加勒比","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"南极洲","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"安提瓜和巴布达","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"美洲","sub-region":"拉丁美洲和加勒比","intermediate-region":"加勒比","region-code":"019","s…