Cómo usar la API de categorización de sitios web

Tu PM pidió "etiquetar automáticamente el sitio web y el dominio de correo electrónico de cada cliente por categoría" y necesitas algo que puedas entregar esta semana. Al final de este artículo, podrás enviar una URL completa o una dirección de correo electrónico a la API de categorización de sitios web en Zyla API Hub y recibir de vuelta categorías concretas (con confianza), una URL de logo y metadatos relacionados que puedes integrar directamente en tu enriquecimiento, enrutamiento o canal de análisis.

Qué hace esta API y cuándo usarla

La API de categorización de sitios web clasifica una ruta de URL (no solo el dominio raíz) o un dominio de correo electrónico y devuelve categorías con puntajes de confianza, además de útiles extras como una URL de logo y enlaces sociales cuando están disponibles. Las integraciones típicas incluyen enriquecimiento de CRM, enrutamiento de clientes potenciales por industria, moderación de contenido y segmentación de análisis.

Ilustración: Cómo usar la API de categorización de sitios web

Puedes:

Categorizar una URL completa (por ejemplo, páginas de destino, publicaciones de blog, URLs de productos).
Categorizar un dominio de correo electrónico de un registro de contacto para inferir el contexto de la organización.

La API está disponible en Zyla API Hub, que proporciona una cuenta, una clave API y un modelo de suscripción más cuota a través de miles de APIs. Consulta la página de la API para conocer las opciones de acceso y precios actuales.

Comenzando en Zyla API Hub

Abre la lista de la API de categorización de sitios web, haz clic en Suscribirse o Comenzar prueba gratuita cuando esté disponible, y copia tu clave API. La autenticación es un solo encabezado HTTP: Authorization: Bearer YOUR_API_KEY.

Comienza aquí: Comienza prueba de 7 días en la API de categorización de sitios web. Zyla utiliza suscripción + cuota (no pago por llamada). Para una primera integración, normalmente verás una prueba de 7 días o una cuota de solicitudes limitada; consulta la lista para la opción actual.

Puntos finales que puedes llamar

Esta API expone dos puntos finales POST en Zyla API Hub. Ambos requieren el encabezado de autorización y aceptan parámetros de formulario codificados en URL.

1) URL: categorizar una ruta de URL completa

Utiliza esto cuando necesites clasificar una página específica, no solo el dominio raíz.

Método: POST
URL de solicitud: https://zylalabs.com/api/12/website-categorization-api/48/url
Parámetro requerido: url (la URL completa que deseas categorizar)

curl oficial (copia/pega tal cual y reemplaza 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"

Respuesta JSON oficial de ejemplo:

{
"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…

Lo que realmente usarás:

domain.categories: lista de objetos de categoría. Cada objeto incluye:
- name: la ruta de taxonomía (por ejemplo, “/Internet & Telecom/Email & Messaging/Email”).
- confidence: puntaje numérico que indica la confianza en la clasificación.
- identificadores IAB cuando estén disponibles (por ejemplo, IAB19-15, IAB-623-619).
domain.logo_url: útil para insignias de UI o tarjetas de CRM.
domain.social_media: las URL pueden estar presentes o ser nulas; maneja las verificaciones nulas.
objects.company: metadatos como nombre, campos de ubicación, employeesRange, revenue, tags e indicadores de pila tecnológica cuando estén disponibles.
success: booleano para confirmar una categorización exitosa.

Ejemplo en Python: categorizar una URL y elegir la categoría principal

Este ejemplo envía datos codificados en formulario con el encabezado de autorización, luego extrae el nombre de la categoría principal y la confianza. También demuestra un acceso básico seguro contra nulos.

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}",
}
# El punto final espera datos de formulario codificados en URL
data = {
"url": target_url
}
resp = requests.post(URL, headers=headers, data=data, timeout=30)
resp.raise_for_status()
payload = resp.json()

# Leer campos de forma segura
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) Correo electrónico: categorizar por dominio de correo electrónico

Utiliza esto cuando tengas una dirección de correo electrónico y quieras inferir la categoría del dominio. Esto es conveniente en CRM o automatización de marketing, donde el correo electrónico es el identificador principal.

Método: POST
URL de solicitud: https://zylalabs.com/api/12/website-categorization-api/1989/email
Parámetro requerido: email (la dirección de correo electrónico cuyo dominio deseas categorizar)

curl oficial:

Ejemplo de respuesta (truncado como se proporciona en la lista):

Ten en cuenta que la estructura aún incluye domain.categories, y los campos pueden ser nulos cuando los datos no están disponibles. Siempre verifica los nulos.

Detalles de implementación que ahorran tiempo

Autenticación: incluye Authorization: Bearer YOUR_API_KEY en cada solicitud.
Codificación: ambos puntos finales esperan parámetros de formulario codificados en URL (como se muestra por --data-urlencode en curl).
Cuerpo de solicitud: solo envía el parámetro requerido para cada punto final:
- El punto final de URL requiere: url
- El punto final de correo electrónico requiere: email
No agregues claves adicionales.
Nulabilidad: muchos campos (por ejemplo, URLs de redes sociales o metadatos de la empresa) pueden ser nulos. Protege tus accesores.
Cacheo: si categorizas repetidamente los mismos dominios/URLs, agrega un caché a nivel de aplicación indexado por URL normalizada o dominio de correo electrónico para reducir llamadas y latencia.
Batching: la lista expone puntos finales de un solo elemento. Si necesitas rendimiento por lotes, ejecuta trabajadores concurrentes del lado del cliente mientras respetas tu cuota de suscripción.
Manejo de errores: verifica los códigos de estado HTTP y el booleano de éxito en la respuesta. Si falta un campo, trátalo como no disponible en lugar de un error.
Consistencia: una URL de página puede producir una categoría más específica que su dominio raíz. Prefiere el punto final de URL para flujos de trabajo por página.

Casos de uso prácticos que puedes construir esta semana

Enrutamiento de clientes potenciales: categoriza la URL del sitio web enviada en tu formulario de registro y asígnala a la cola de ventas correcta según la industria/categoría.
Enriquecimiento de ESP/CRM: cuando solo tienes un correo electrónico, utiliza el punto final de correo electrónico para inferir la categoría del dominio y etiquetar automáticamente a los contactos para flujos de incorporación.
Segmentación y exclusiones de anuncios: clasifica las URLs de contenido para asegurar que las campañas solo se ejecuten contra categorías permitidas.
Análisis de contenido: etiqueta los enlaces salientes en tu producto o blog por categoría para construir un panel de compromiso a nivel de categoría.
Pulido de UI: muestra la logo_url junto a una empresa o vista previa de enlace en tu aplicación.

Llama a la API desde agentes de IA a través de MCP

También puedes activar estos mismos puntos finales desde un cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf) apuntando tu agente a la puerta de enlace MCP de Zyla. Proporciona tu clave API a la configuración de tu cliente MCP y llama a los mismos puntos finales del hub a través de invocaciones de herramientas. Consulta MCP para detalles de conexión. La puerta de enlace MCP utiliza tu clave API de Zyla y suscripción; los resultados coinciden con las llamadas HTTP directas mostradas arriba.

Un flujo de trabajo mínimo para enviar

Crea una cuenta en Zyla y suscríbete a la API desde la página de listado. Copia tu clave API.
Para entradas de URL (por ejemplo, desde formularios o webhooks), POST a https://zylalabs.com/api/12/website-categorization-api/48/url con url configurado a la URL completa de la página.
Para entradas de correo electrónico (por ejemplo, desde eventos de CRM), POST a https://zylalabs.com/api/12/website-categorization-api/1989/email con email configurado a la dirección de correo del usuario.
Lee domain.categories[0].name y domain.categories[0].confidence; guárdalos en tu base de datos junto con logo_url.
Agrega verificaciones nulas y un simple cacheo para URLs/dominios repetidos. Monitorea tu cuota de suscripción en Zyla.

FAQ

¿Qué autenticación utiliza la API?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud.

¿Puedo categorizar una página específica, no solo el dominio principal?
Sí. Utiliza el punto final de URL en https://zylalabs.com/api/12/website-categorization-api/48/url y pasa la ruta completa de la URL.

¿En qué campos debo confiar para el enrutamiento?
Lee domain.categories, especialmente el nombre y la confianza del primer elemento. Mantén un camino seguro contra nulos para campos opcionales como logo_url o social_media.

¿Hay un plan gratuito?
Esta API utiliza suscripción + cuota y no ofrece un plan gratuito. Consulta la lista para conocer las opciones de acceso actuales; normalmente verás una prueba de 7 días o una cuota de solicitudes limitada para evaluación.

¿Cómo integro esto con mi agente de codificación de IA?
Conecta tu agente a la puerta de enlace MCP de Zyla e invoca los mismos puntos finales como herramientas. Consulta el enlace de MCP arriba para detalles de configuración.

¿Listo para categorizar tráfico real y enviar tu integración? Comienza tu evaluación aquí: Comienza prueba de 7 días en la API de categorización de sitios web. Tu suscripción se ejecuta en Zyla API Hub con una única clave API que también puedes usar a través de agentes habilitados para MCP.