您的 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 调用匹配。
一个最小的工作流程
- 创建一个 Zyla 帐户并从列表页面订阅 API。复制您的 API 密钥。
- 对于 URL 输入（例如，来自表单或 Webhook），POST 到 https://zylalabs.com/api/12/website-categorization-api/48/url，url 设置为完整页面 URL。
- 对于电子邮件输入（例如，来自 CRM 事件），POST 到 https://zylalabs.com/api/12/website-categorization-api/1989/email，email 设置为用户的电子邮件。
- 读取 domain.categories[0].name 和 domain.categories[0].confidence；将它们与 logo_url 一起存储在您的数据库中。
- 添加 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 密钥。
