Tienes una lista de dominios, URLs completas y direcciones de correo electrónico, y necesitas etiquetarlas automáticamente en categorías amigables para el marketing o al estilo IAB antes de que termine la semana. Al final de esta guía, podrás enviar una URL o un dominio de correo electrónico a la API de Categorización de Sitios Web en Zyla API Hub y recibir categorías estructuradas, puntajes de confianza y metadatos útiles que puedes usar inmediatamente en la puntuación de leads, moderación de contenido, enrutamiento o análisis.
Lo que esta API entrega
La API de Categorización de Sitios Web clasifica propiedades web y dominios de correo electrónico en categorías y devuelve contexto adicional como una URL de logo, enlaces sociales cuando están disponibles, y atributos opcionales de la empresa. Funciona en:
- URLs completas (por ejemplo, https://example.com/path) para categorización a nivel de página.
- Dominios de correo electrónico (por ejemplo, gmail.com de [email protected]) para reconocimiento de buzón/proveedor y información relacionada.
Las aplicaciones típicas incluyen enriquecimiento de leads, alineación de publicidad, filtrado de contenido y segmentación de análisis. Interactuarás con dos puntos finales POST que aceptan un solo parámetro y devuelven JSON.
Comenzando en Zyla API Hub
Abre la lista de APIs y suscríbete para obtener una clave de API. Zyla API Hub utiliza un modelo de suscripción + cuota (no pago por llamada). Esta API ofrece una prueba de 7 días en su página de listado para que puedas prototipar rápidamente sin comprometerte.
- Ve a la lista de la API de Categorización de Sitios Web: Comienza la prueba de 7 días en la API de Categorización de Sitios Web.
- Haz clic en Suscribirse (o Comenzar Prueba Gratuita cuando esté disponible), luego copia tu clave de API.
- Usa el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.
Una cuenta, una clave de API y un modelo de suscripción consistente se aplican en el catálogo de más de 10,000 APIs públicas de Zyla Hub. Explora el mercado en zylalabs.com cuando estés listo para agregar enriquecimiento o utilidades a tu stack.
Resumen de puntos finales
1) Categorización de URL
Usa esto para categorizar una ruta de URL completa, 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 (por ejemplo, https://google.com)
Lo que recibes: categorías con confianza, un logo_url, y cuando está disponible, enlaces de redes sociales y objetos de empresa. Usa esto cuando el contexto a nivel de página importa o cuando no quieras normalizar a un dominio básico.
2) Categorización de dominio de correo electrónico
Envía una dirección de correo electrónico para categorizar y recuperar información a nivel de dominio para el proveedor/dominio de ese correo.
- Método: POST
- URL de solicitud: https://zylalabs.com/api/12/website-categorization-api/1989/email
- Parámetro requerido: email (por ejemplo, [email protected])
Lo que recibes: categorías, logo_url, y cuando está disponible, datos de registro de dominio y una lista de dominios similares. Usa esto para segmentar leads o usuarios por proveedor de buzón o para enriquecer registros de CRM.
cURL mínimo, copia y pega para categorización de URL
Envía una URL completa y recibe datos de categoría con valores de confianza y metadatos relacionados.
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 de muestra oficial:
{
"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…Campos que típicamente usarás:
- domain.categories: array de categorías con confianza. name proporciona un camino de taxonomía legible; otros campos se mapean a códigos IAB.
- domain.logo_url: URL del logo del proveedor o empresa.
- domain.social_media: enlaces sociales conocidos cuando están disponibles (pueden ser nulos).
- success: verifica esto antes de confiar en la carga útil.
- objects.company: metadatos opcionales de la empresa como nombre, ubicación, etiquetas y entradas de stack tecnológico cuando están disponibles.
Ejemplo en Python: categorizar una URL y leer campos clave
Este ejemplo publica una URL, verifica la bandera de éxito e imprime la categoría principal con su confianza y la URL del logo. Usa solo el punto final y parámetros documentados.
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}",
}
# Usa codificación de formulario para reflejar el comportamiento de --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 devolvió 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("Categoría principal:", top.get("name"))
print("Confianza:", top.get("confidence"))
else:
print("No se encontraron categorías")
print("URL del logo:", logo_url)
return payload
if __name__ == "__main__":
categorize_url("https://google.com")Punto final de correo electrónico: categorización rápida por dominio de correo
Envía una dirección de correo electrónico; la API infiere el dominio y devuelve la categorización y la información relacionada.
- Método: POST
- URL de solicitud: https://zylalabs.com/api/12/website-categorization-api/1989/email
- Parámetro: email (requerido)
Ejemplo de respuesta:
De esta carga útil puedes extraer:
- domain.categories: categoriza el dominio del proveedor de buzón.
- logo_url: renderiza un logo junto a los correos electrónicos de los usuarios en tu interfaz.
- domain_registration_data y similar_domains cuando estén disponibles: útil para heurísticas o coincidencias difusas.
Patrones de implementación que se envían
- Puntuación de leads: llama al punto final de correo electrónico al registrarte para etiquetar el dominio y ajustar puntajes (por ejemplo, categoría “Email” → proveedor de buzón de consumidor).
- Enrutamiento de contenido: para una lista de URLs, envía cada una al punto final de URL y enruta a una cola de moderación o procesamiento relevante según la categoría principal.
- Alineación de anuncios: mapea las categorías devueltas a tu taxonomía interna o usa directamente los campos de mapeo de IAB presentes en el array de categorías.
- Enriquecimiento de UI: muestra un logo_url y enlaces sociales conocidos para dominios reconocidos para agregar contexto útil en los tableros.
Detalles de solicitud que ahorran tiempo
- Autorización: establece el encabezado HTTP Authorization: Bearer YOUR_API_KEY.
- Codificación de formulario: los ejemplos de Hub usan --data-urlencode. En tu código, envía campos de formulario (application/x-www-form-urlencoded) o un cuerpo de formulario típico para reflejar esto.
- Manejo de nulos: los enlaces sociales y algunos campos de empresa pueden ser nulos. Protege tu análisis JSON en consecuencia.
- Cacheo: las categorías para la misma URL/dominio no cambian con frecuencia. Cachea resultados por URL canónica o por dominio donde sea apropiado.
- Batching: si estás categorizando listas, paraleliza a nivel de cliente y respeta tu cuota de suscripción. Consulta la lista de API para tus opciones de acceso y precios actuales.
Llamadas desde agentes de IA a través de MCP
Si estás orquestando con Claude Code, Cursor, Windsurf, o cualquier cliente compatible con MCP, puedes enrutar llamadas a través del punto final MCP de Zyla. Proporciona tu clave de API en la URL de MCP y haz que tu agente llame a los puntos finales documentados en tu nombre.
- Punto final MCP: MCP
- Uso: configura tu herramienta con el punto final MCP y tu clave. Desde el agente, llama a los mismos puntos finales de la API de Categorización de Sitios Web que se muestran arriba con los parámetros requeridos (url o email) y el encabezado de Autorización.
Esto te permite mantener los pasos de categorización dentro de un flujo de trabajo autónomo mientras mantienes una única clave de API a través de herramientas en el ecosistema de Zyla. Explora más APIs para tus agentes en zylalabs.com.
Solución de problemas y lista de verificación de producción
- Valida entradas: asegúrate de que la url sea una URL absoluta correctamente formateada y que el correo sea sintácticamente válido antes de enviar.
- Verifica el éxito: verifica que el campo de éxito sea verdadero antes de leer los arrays de categorías.
- Fallbacks: cuando categories esté vacío o nulo, decide una ruta predeterminada (por ejemplo, “Sin Categorizar”).
- Timeouts/retries: establece timeouts en el cliente y reintenta de manera idempotente en errores de red transitorios. Evita bucles de reintento que puedan consumir rápidamente la cuota.
- Registro: registra el nombre de la categoría y la confianza para ayudar en la afinación y depuración futuras.
Preguntas Frecuentes
¿Qué método de autenticación se requiere?
Usa el encabezado HTTP Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Puedo categorizar una ruta completa (no solo un dominio raíz)?
Sí, usa el punto final de URL (POST a https://zylalabs.com/api/12/website-categorization-api/48/url) con el parámetro url.
¿Cómo categorizar a los usuarios por sus proveedores de correo electrónico?
Usa el punto final de correo electrónico (POST a https://zylalabs.com/api/12/website-categorization-api/1989/email) con el parámetro email. Analiza domain.categories para la categoría principal y la confianza.
¿Qué modelo de plan utiliza Zyla?
Suscripción + cuota. Esta API ofrece una prueba de 7 días en su página de listado para que puedas evaluar rápidamente. Consulta la página de la API para las opciones de acceso y precios actuales.
¿Qué campos se pueden asumir que están presentes?
Siempre verifica el éxito. El array domain.categories, logo_url, social_media y los campos objects.company pueden estar presentes, pero algunos valores pueden ser nulos. Protege contra campos faltantes.
Envíalo
Ahora tienes ejemplos de cURL y Python funcionales para la API de Categorización de Sitios Web. Suscríbete, obtén tu clave y comienza a clasificar URLs y dominios de correo electrónico hoy: Comienza la prueba de 7 días en la API de Categorización de Sitios Web.
