流量来源和概述的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示例：

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

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…

क्या आप Zyla API HUB का उपयोग करने के लिए तैयार हैं?

अभी आज़माएँ!

流量来源和概述的API

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

在Zyla API Hub上开始

您将使用的端点

1) 流量来源和概述

2) 国家列表

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

节省时间的实际实施细节

现实世界的用例

CRM中的线索丰富

归因仪表板

SEO和内容规划

从AI代理（MCP）调用API

发货前的验证清单

常见问题解答

क्या आप Zyla API HUB का उपयोग करने के लिए तैयार हैं?

संबंधित पोस्ट्स

हाल की पोस्ट्स

API प्रदाताओं के लिए

Zyla API Hub VS

Marketplace

कंपनी

हमसे संपर्क करें

流量来源和概述的API

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

在Zyla API Hub上开始

您将使用的端点

1) 流量来源和概述

2) 国家列表

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

节省时间的实际实施细节

现实世界的用例

CRM中的线索丰富

归因仪表板

SEO和内容规划

从AI代理（MCP）调用API

发货前的验证清单

常见问题解答

क्या आप Zyla API HUB का उपयोग करने के लिए तैयार हैं?

संबंधित पोस्ट्स

API for traffic source and overview

ऑस्ट्रेलिया रियल्टी एपीआई के साथ काम करना

FlashScore - लाइव API का उपयोग कैसे करें

मैच कमेंट्री प्राप्त करने के लिए API

बैंक डेटा के लिए API

Working with Site Traffic API

खोजें

संबंधित पोस्ट्स

हाल की पोस्ट्स

API प्रदाताओं के लिए

Zyla API Hub VS

Marketplace

कंपनी