如何使用网站分类 API

您的 PM 要求“按类别自动标记每个潜在客户的网站和电子邮件域”，您需要一些可以在本周内交付的东西。通过本文，您将能够将完整的 URL 或电子邮件地址发送到 Zyla API Hub 的网站分类 API，并获得具体的类别（带有置信度）、一个 logo URL 和相关的元数据，您可以直接将其插入到您的数据丰富、路由或分析管道中。

此 API 的功能及使用时机

网站分类 API 对 URL 路径（不仅仅是根域）或电子邮件域进行分类，并返回带有置信度分数的类别，以及在可用时提供的有用附加信息，如 logo URL 和社交链接。典型的集成包括 CRM 丰富、按行业路由潜在客户、内容审核和分析细分。

您可以：

• 对完整的 URL 进行分类（例如，着陆页、博客文章、产品 URL）。
• 从联系人记录中对电子邮件域进行分类，以推断组织上下文。

该 API 可在 Zyla API Hub 上使用，提供一个帐户、一个 API 密钥，以及跨数千个 API 的订阅加配额模型。请查看 API 页面以获取当前访问选项和定价。

在 Zyla API Hub 上开始

打开网站分类 API 列表，点击订阅或开始免费试用（如可用），并复制您的 API 密钥。身份验证是一个 HTTP 头：Authorization: Bearer YOUR_API_KEY。

从这里开始： 开始 7 天试用网站分类 API。Zyla 使用订阅 + 配额（而不是按调用付费）。对于第一次集成，您通常会看到 7 天的试用或有限的请求配额；请查看列表以获取当前选项。

您可以调用的端点

该 API 在 Zyla API Hub 上公开了两个 POST 端点。两个都需要 Authorization 头，并接受 URL 编码的表单参数。

1) URL：对完整的 URL 路径进行分类

当您需要对特定页面进行分类时，请使用此方法，而不仅仅是根域。

• 方法：POST
• 请求 URL： https://zylalabs.com/api/12/website-categorization-api/48/url
• 必需参数：url（您想要分类的完整 URL）

官方 curl（按原样复制/粘贴并替换 YOUR_API_KEY）：

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"

官方示例 JSON 响应：

{
"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：分类路径（例如，“/Internet & Telecom/Email & Messaging/Email”）。
  • confidence：表示分类置信度的数字分数。
  • 可用时的 IAB 标识符（例如，IAB19-15，IAB-623-619）。
• domain.logo_url：方便用于 UI 徽章或 CRM 卡片。
• domain.social_media：URL 可能存在或为 null；处理 null 检查。
• objects.company：元数据，如名称、位置字段、employeesRange、revenue、tags 和可用时的技术栈指示符。
• success：布尔值以确认分类成功。

Python 示例：对 URL 进行分类并选择顶部类别

此示例使用 Authorization 头发布表单编码数据，然后提取顶部类别名称和置信度。它还演示了基本的 null 安全访问。

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/12/website-categorization-api/48/url"

def categorize_url(target_url: str):
headers = {
"Authorization": f"Bearer {API_KEY}",
}
# 该端点期望 URL 编码的表单数据
data = {
"url": target_url
}
resp = requests.post(URL, headers=headers, data=data, timeout=30)
resp.raise_for_status()
payload = resp.json()

# 安全读取字段
domain = payload.get("domain") or {}
cats = domain.get("categories") or []
top = cats[0] if cats else None

result = {
"success": payload.get("success") is True,
"top_category_name": (top or {}).get("name"),
"top_category_confidence": (top or {}).get("confidence"),
"logo_url": domain.get("logo_url"),
"social_youtube": (domain.get("social_media") or {}).get("youtube_url"),
"company_name": ((payload.get("objects") or {}).get("company") or {}).get("name"),
}
return result

if __name__ == "__main__":
out = categorize_url("https://google.com")
print(out)

2) 电子邮件：按电子邮件域进行分类

当您有电子邮件地址并希望推断域的类别时，请使用此方法。这在 CRM 或营销自动化中很方便，因为电子邮件是主要标识符。

• 方法：POST
• 请求 URL： https://zylalabs.com/api/12/website-categorization-api/1989/email
• 必需参数：email（您想要分类的电子邮件地址的域）

官方 curl：

示例响应（根据列表提供的内容截断）：

请注意，结构仍然包括 domain.categories，当数据不可用时字段可能为 null。始终进行 null 检查。

节省时间的实施细节

• 身份验证：在每个请求中包含 Authorization: Bearer YOUR_API_KEY。
• 编码：两个端点都期望 URL 编码的表单参数（如 curl 中的 --data-urlencode 所示）。
• 请求体：仅发送每个端点所需的参数：
  • URL 端点要求：url
  • 电子邮件端点要求：email
  不要添加额外的键。
• 可空性：许多字段（例如，社交媒体 URL 或公司元数据）可以为 null。保护您的访问器。
• 缓存：如果您重复对相同的域/URL 进行分类，请添加一个应用级缓存，以标准化 URL 或电子邮件域为键，以减少调用和延迟。
• 批处理：列表公开单项端点。如果您需要批量吞吐量，请在客户端运行并发工作者，同时遵循您的订阅配额。
• 错误处理：检查 HTTP 状态代码和响应中的成功布尔值。如果缺少字段，将其视为不可用，而不是错误。
• 一致性：页面 URL 可以产生比其根域更具体的类别。对于逐页工作流，优先使用 URL 端点。

您可以在本周构建的实际用例

• 潜在客户路由：对您注册表单中提交的网站 URL 进行分类，并根据行业/类别分配到正确的销售队列。
• ESP/CRM 丰富：当您只有电子邮件时，使用电子邮件端点推断域类别并自动标记联系人以进行入职流程。
• 广告定位和排除：对内容 URL 进行分类，以确保活动仅针对允许的类别运行。
• 内容分析：按类别标记您产品或博客中的外部链接，以构建类别级参与仪表板。
• UI 美化：在您的应用中显示 logo_url 旁边的公司或链接预览。

通过 MCP 从 AI 代理调用 API

您还可以通过指向 Zyla MCP 网关，从与 MCP 兼容的客户端（例如 Claude Code、Cursor、Windsurf）触发这些相同的端点。将您的 API 密钥提供给 MCP 客户端配置，并通过工具调用调用相同的中心端点。有关连接详细信息，请参见 MCP。MCP 网关使用您的 Zyla API 密钥和订阅；结果与上面显示的直接 HTTP 调用匹配。

一个最小的工作流程

1. 创建一个 Zyla 帐户并从列表页面订阅 API。复制您的 API 密钥。
2. 对于 URL 输入（例如，来自表单或 Webhook），POST 到 https://zylalabs.com/api/12/website-categorization-api/48/url，url 设置为完整页面 URL。
3. 对于电子邮件输入（例如，来自 CRM 事件），POST 到 https://zylalabs.com/api/12/website-categorization-api/1989/email，email 设置为用户的电子邮件。
4. 读取 domain.categories[0].name 和 domain.categories[0].confidence；将它们与 logo_url 一起存储在您的数据库中。
5. 添加 null 检查和简单缓存以处理重复的 URL/域。监控您在 Zyla 的订阅配额。

常见问题解答

API 使用什么身份验证？
在每个请求中发送 Authorization: Bearer YOUR_API_KEY。

我可以对特定页面进行分类，而不仅仅是主页域吗？
是的。使用 URL 端点 https://zylalabs.com/api/12/website-categorization-api/48/url，并传递完整的 URL 路径。

我应该依赖哪些字段进行路由？
读取 domain.categories，特别是第一个项目的名称和置信度。为 logo_url 或 social_media 等可选字段保持一个 null 安全路径。

是否有免费计划？
该 API 使用订阅 + 配额，不提供免费计划。请查看列表以获取当前访问选项；通常您会看到 7 天的试用或有限的请求配额以供评估。

我如何将其与我的 AI 编码代理集成？
将您的代理连接到 Zyla 的 MCP 网关，并调用相同的端点作为工具。有关设置详细信息，请参阅上面的 MCP 链接。

准备好对真实流量进行分类并交付您的集成了吗？在这里开始您的评估： 开始 7 天试用网站分类 API。您的订阅在 Zyla API Hub 上运行，您还可以通过 MCP 启用的代理使用单个 API 密钥。