您有一个域名、完整的 URL 和电子邮件地址的列表，您需要在本周结束之前将它们自动标记为营销友好或 IAB 风格的类别。在本指南结束时，您将能够将 URL 或电子邮件域发送到 Zyla API Hub 的网站分类 API，并返回结构化类别、置信度分数和您可以立即用于潜在客户评分、内容审核、路由或分析的有用元数据。
此 API 提供的内容
网站分类 API 将网络属性和电子邮件域分类为类别，并返回附加上下文，如 logo URL、社交链接（如有）和可选的公司属性。它适用于：
- 完整的 URL（例如，https://example.com/path）用于页面级分类。
- 电子邮件域（例如，从 [email protected] 的 gmail.com）用于邮箱/提供商识别及相关信息。
典型应用包括潜在客户丰富、广告定位对齐、内容过滤和分析细分。您将与两个接受单个参数并返回 JSON 的 POST 端点进行交互。
在 Zyla API Hub 上开始
打开 API 列表并订阅以获取 API 密钥。Zyla API Hub 使用订阅 + 配额模型（不是按调用付费）。此 API 在其列表页面提供 7 天试用，以便您可以快速原型而无需承诺。
- 访问网站分类 API 列表：开始 7 天试用网站分类 API。
- 点击订阅（或在可用时开始免费试用），然后复制您的 API 密钥。
- 在每个请求中使用头 Authorization: Bearer YOUR_API_KEY。
一个帐户、一个 API 密钥，以及 Zyla Hub 目录中超过 10,000 个公共 API 的一致订阅模型适用。准备好为您的堆栈添加丰富或实用工具时，请在 zylalabs.com 探索市场。
端点概述
1) URL 分类
使用此方法对完整的 URL 路径进行分类，而不仅仅是根域。
- 方法：POST
- 请求 URL：https://zylalabs.com/api/12/website-categorization-api/48/url
- 必需参数：url（例如，https://google.com）
您将获得的内容：具有置信度的类别、logo_url，以及（如有）社交媒体链接和公司对象。当页面级上下文很重要时，或当您不想归一化到裸域时使用此方法。
2) 电子邮件域分类
提交电子邮件地址以对其进行分类并检索该电子邮件的提供商/域的域级信息。
- 方法：POST
- 请求 URL：https://zylalabs.com/api/12/website-categorization-api/1989/email
- 必需参数：email（例如，[email protected]）
您将获得的内容：类别、logo_url，以及（如有）域注册数据和类似域的列表。使用此方法按邮箱提供商对潜在客户或用户进行细分，或丰富 CRM 记录。
最小的、复制粘贴的 cURL 用于 URL 分类
发送完整的 URL 并接收带有置信值和相关元数据的类别数据。
curl -s -X POST "https://zylalabs.com/api/12/website-categorization-api/48/url"
-H "Authorization: Bearer YOUR_API_KEY"
--data-urlencode "url=https://google.com"官方示例响应：
{
"domain": {
"categories": [
{
"confidence": 0.9019761085510254,
"name": "/Internet & Telecom/Email & Messaging/Email",
"IAB19-15": "Email",
"IAB-623-619": "Internet - Email"
}
],
"logo_url": "https://klazify.s3.amazonaws.com/187668924417925096926ad786fcaae866.96410880.png",
"social_media": {
"facebook_url": null,
"twitter_url": null,
"instagram_url": null,
"medium_url": null,
"youtube_url": "https://www.youtube.com/?gl=US&tab=w1",
"pinterest_url": null,
"linkedin_url": null,
"github_url": null
}
},
"success": true,
"objects": {
"company": {
"name": "Google",
"city": "Mountain View",
"stateCode": "CA",
"countryCode": "US",
"employeesRange": "100K+",
"revenue": 257637000000,
"raised": null,
"tags": [
"Internet",
"Publishers",
"Broadcasting",
"Information",
"Publishing",
"Web Search",
"Web & Client Portals",
"Technology",
"Web Services & Apps",
"Information Technology & Services",
"B2C",
"SAAS",
"B2B"
],
"tech": [
"google_apps",
"db2",
"media.net",
"grafana",
"marchex",
"oracle_crm",
"smartsheet",
"sybase",
"apache_kafka",
"sage_50cloud",
"splunk",
"oracle_endeca",
"informatica",
"appnexus",
"apache_http_server",
"apache_spark",
"ibm_infosphere",
"wrike",
"sap_hybris_marketing",
"couchbase",
"atlassian_fisheye",
"gitlab",
"dropbox",
"woo_commerce",
"workamajig",
"workday",
"atlassian_jira",
"sas_enterprise",
"oracle_cash_and_treasury_management",
"qliktech",
"thomson_reuters_eikon",
"flexer…您通常会使用的字段：
- domain.categories：具有置信度的类别数组。name 提供可读的分类路径；其他字段映射到 IAB 代码。
- domain.logo_url：提供商或公司 logo URL。
- domain.social_media：已知的社交链接（如有）。（可能为 null）。
- success：在信任有效负载之前检查此项。
- objects.company：可选的公司元数据，如名称、位置、标签和技术栈条目（如有）。
Python 示例：对 URL 进行分类并读取关键字段
此示例发布一个 URL，检查成功标志，并打印具有置信度的顶级类别及其 logo URL。它仅使用文档中记录的端点和参数。
import requests
API_KEY = "YOUR_API_KEY"
ENDPOINT = "https://zylalabs.com/api/12/website-categorization-api/48/url"
def categorize_url(target_url: str):
headers = {
"Authorization": f"Bearer {API_KEY}",
}
# 使用表单编码来镜像 --data-urlencode 行为
data = {
"url": target_url
}
resp = requests.post(ENDPOINT, headers=headers, data=data, timeout=20)
resp.raise_for_status()
payload = resp.json()
if not payload.get("success"):
raise RuntimeError("API returned success=false")
domain = payload.get("domain", {})
categories = domain.get("categories", []) or []
logo_url = domain.get("logo_url")
top = categories[0] if categories else None
if top:
print("Top category:", top.get("name"))
print("Confidence:", top.get("confidence"))
else:
print("No categories found")
print("Logo URL:", logo_url)
return payload
if __name__ == "__main__":
categorize_url("https://google.com")电子邮件端点：通过电子邮件域快速分类
提交电子邮件地址；API 推断域并返回分类和相关信息。
- 方法：POST
- 请求 URL：https://zylalabs.com/api/12/website-categorization-api/1989/email
- 参数：email（必需）
示例响应：
从此有效负载中，您可以提取：
- domain.categories：对邮箱提供商的域进行分类。
- logo_url：在您的 UI 中渲染用户电子邮件旁边的 logo。
- domain_registration_data 和 similar_domains（如有）：对启发式或模糊匹配有帮助。
实施模式
- 潜在客户评分：在注册时调用电子邮件端点以标记域并调整分数（例如，“电子邮件”类别 → 消费者邮箱提供商）。
- 内容路由：对于 URL 列表，将每个发送到 URL 端点，并根据顶级类别路由到相关的审核或处理队列。
- 广告对齐：将返回的类别映射到您的内部分类法，或直接使用类别数组中存在的 IAB 映射字段。
- UI 丰富：显示 logo_url 和已知社交链接，以便为已识别的域在仪表板中添加有用的上下文。
节省时间的请求细节
- 授权：设置 HTTP 头 Authorization: Bearer YOUR_API_KEY。
- 表单编码：Hub 示例使用 --data-urlencode。在您的代码中，发送表单字段（application/x-www-form-urlencoded）或典型的表单主体以镜像此行为。
- 空值处理：社交链接和某些公司字段可能为空。相应地保护您的 JSON 解析。
- 缓存：相同 URL/域的类别不会频繁更改。根据规范 URL 或域缓存结果（如适用）。
- 批处理：如果您正在对列表进行分类，请在客户端级别并行化，并遵守您的订阅配额。检查 API 列表以获取当前访问选项和定价。
通过 MCP 从 AI 代理调用
如果您正在与 Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端进行编排，您可以通过 Zyla 的 MCP 端点路由调用。在 MCP URL 中提供您的 API 密钥，并让您的代理代表您调用文档中的端点。
- MCP 端点：MCP
- 用法：使用 MCP 端点和您的密钥配置您的工具。从代理调用上面显示的相同网站分类 API 端点，使用所需参数（url 或 email）和授权头。
这使您能够在保持 Zyla 生态系统中跨工具维护单个 API 密钥的同时，将分类步骤保留在自主工作流中。准备好为您的代理探索更多 API，请访问 zylalabs.com。
故障排除和生产检查清单
- 验证输入：确保 url 是格式正确的绝对 URL，email 在发送之前是语法有效的。
- 检查成功：在读取类别数组之前验证 success 字段为 true。
- 后备：当类别为空或为 null 时，决定默认路由（例如，“未分类”）。
- 超时/重试：设置客户端超时，并在瞬态网络错误上进行幂等重试。避免可能快速消耗配额的重试循环。
- 日志记录：记录类别名称和置信度，以帮助未来的调整和调试。
常见问题解答
需要什么身份验证方法？
在每个请求中使用 HTTP 头 Authorization: Bearer YOUR_API_KEY。
我可以对完整路径进行分类（不仅仅是根域）吗？
是的，使用 URL 端点（POST 到 https://zylalabs.com/api/12/website-categorization-api/48/url）并使用 url 参数。
我如何按电子邮件提供商对用户进行分类？
使用电子邮件端点（POST 到 https://zylalabs.com/api/12/website-categorization-api/1989/email）并使用 email 参数。解析 domain.categories 以获取主要类别和置信度。
Zyla 使用什么计划模型？
订阅 + 配额。此 API 在其列表页面提供 7 天试用，以便您可以快速评估。检查 API 页面以获取当前访问选项和定价。
哪些字段可以安全假设存在？
始终检查 success。domain.categories 数组、logo_url、social_media 和 objects.company 字段可能存在，但某些值可能为 null。防止缺失字段。
发布它
您现在拥有网站分类 API 的有效 cURL 和 Python 示例。订阅，获取您的密钥，并立即开始对 URL 和电子邮件域进行分类：开始 7 天试用网站分类 API。
