Você tem uma lista de domínios, URLs completas e endereços de e-mail, e precisa categorizá-los automaticamente em categorias amigáveis ao marketing ou no estilo IAB até o final da semana. Ao final deste guia, você será capaz de enviar uma URL ou um domínio de e-mail para a API de Categorização de Sites no Zyla API Hub e receber de volta categorias estruturadas, pontuações de confiança e metadados úteis que você pode usar imediatamente na pontuação de leads, moderação de conteúdo, roteamento ou análises.
O que esta API entrega
A API de Categorização de Sites classifica propriedades da web e domínios de e-mail em categorias e retorna contexto adicional como uma URL de logo, links sociais quando disponíveis e atributos opcionais da empresa. Ela funciona em:
- URLs completas (por exemplo, https://example.com/path) para categorização em nível de página.
- Domínios de e-mail (por exemplo, gmail.com de [email protected]) para reconhecimento de caixa de entrada/provedor e informações relacionadas.
Aplicações típicas incluem enriquecimento de leads, alinhamento de segmentação de anúncios, filtragem de conteúdo e segmentação de análises. Você interagirá com dois endpoints POST que aceitam um único parâmetro e retornam JSON.
Começando no Zyla API Hub
Abra a lista de APIs e inscreva-se para obter uma chave de API. O Zyla API Hub utiliza um modelo de assinatura + cota (não é pago por chamada). Esta API oferece um teste de 7 dias em sua página de listagem para que você possa prototipar rapidamente sem compromisso.
- Vá para a lista da API de Categorização de Sites: Comece o teste de 7 dias na API de Categorização de Sites.
- Clique em Inscrever-se (ou Começar Teste Gratuito quando disponível), depois copie sua chave de API.
- Use o cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.
Uma conta, uma chave de API e um modelo de assinatura consistente se aplicam ao catálogo do Zyla Hub de mais de 10.000 APIs públicas. Explore o marketplace em zylalabs.com quando estiver pronto para adicionar enriquecimento ou utilitários ao seu stack.
Visão geral dos endpoints
1) Categorização de URL
Use isso para categorizar um caminho de URL completo, não apenas o domínio raiz.
- Método: POST
- URL da solicitação: https://zylalabs.com/api/12/website-categorization-api/48/url
- Parâmetro necessário: url (por exemplo, https://google.com)
O que você recebe de volta: categorias com confiança, uma logo_url e, quando disponível, links de redes sociais e objetos da empresa. Use isso quando o contexto em nível de página for importante ou quando você não quiser normalizar para um domínio básico.
2) Categorização de domínio de e-mail
Envie um endereço de e-mail para categorizar e recuperar informações em nível de domínio para o provedor/domínio desse e-mail.
- Método: POST
- URL da solicitação: https://zylalabs.com/api/12/website-categorization-api/1989/email
- Parâmetro necessário: email (por exemplo, [email protected])
O que você recebe de volta: categorias, logo_url e, quando disponível, dados de registro de domínio e uma lista de domínios semelhantes. Use isso para segmentar leads ou usuários por provedor de caixa de entrada ou para enriquecer registros de CRM.
cURL mínimo, copy-paste para categorização de URL
Envie uma URL completa e receba dados de categoria com valores de confiança e metadados 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"Resposta de exemplo 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 você normalmente usará:
- domain.categories: array de categorias com confiança. name fornece um caminho de taxonomia legível; outros campos mapeiam para códigos IAB.
- domain.logo_url: URL do logo do provedor ou da empresa.
- domain.social_media: links sociais conhecidos quando disponíveis (podem ser nulos).
- success: verifique isso antes de confiar na carga útil.
- objects.company: metadados opcionais da empresa, como nome, localização, tags e entradas da pilha de tecnologia quando disponíveis.
Exemplo em Python: categorizar uma URL e ler campos-chave
Este exemplo envia uma URL, verifica o sinalizador de sucesso e imprime a categoria principal com sua confiança e a URL do logo. Ele usa apenas o endpoint e os 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}",
}
# Use a codificação de formulário para espelhar o comportamento --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 retornou 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("Categoria principal:", top.get("name"))
print("Confiança:", top.get("confidence"))
else:
print("Nenhuma categoria encontrada")
print("URL do logo:", logo_url)
return payload
if __name__ == "__main__":
categorize_url("https://google.com")Endpoint de e-mail: categorização rápida por domínio de e-mail
Envie um endereço de e-mail; a API infere o domínio e retorna a categorização e informações relacionadas.
- Método: POST
- URL da solicitação: https://zylalabs.com/api/12/website-categorization-api/1989/email
- Parâmetro: email (obrigatório)
Exemplo de resposta:
Com esta carga útil, você pode extrair:
- domain.categories: categorizar o domínio do provedor de caixa de entrada.
- logo_url: renderizar um logo ao lado dos e-mails dos usuários em sua interface.
- domain_registration_data e similar_domains quando disponíveis: úteis para heurísticas ou correspondência difusa.
Padrões de implementação que funcionam
- Pontuação de leads: chame o endpoint de e-mail na inscrição para marcar o domínio e ajustar as pontuações (por exemplo, “Categoria de E-mail” → provedor de caixa de entrada do consumidor).
- Roteamento de conteúdo: para uma lista de URLs, envie cada uma para o endpoint de URL e roteie para uma fila de moderação ou processamento relevante com base na categoria principal.
- Alinhamento de anúncios: mapeie as categorias retornadas para sua taxonomia interna ou use diretamente os campos de mapeamento IAB presentes no array de categorias.
- Enriquecimento da interface: exiba uma logo_url e links sociais conhecidos para domínios reconhecidos para adicionar contexto útil em painéis.
Detalhes da solicitação que economizam tempo
- Autorização: defina o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY.
- Codificação de formulário: os exemplos do Hub usam --data-urlencode. No seu código, envie campos de formulário (application/x-www-form-urlencoded) ou um corpo de formulário típico para espelhar isso.
- Tratamento de nulos: links sociais e alguns campos da empresa podem ser nulos. Proteja sua análise JSON de acordo.
- Cache: categorias para a mesma URL/domínio não mudam com frequência. Armazene resultados por URL canônica ou por domínio quando apropriado.
- Batching: se você estiver categorizando listas, paralelize no nível do cliente e respeite sua cota de assinatura. Verifique a lista de APIs para suas opções de acesso e preços atuais.
Chamadas de agentes de IA via MCP
Se você estiver orquestrando com Claude Code, Cursor, Windsurf ou qualquer cliente compatível com MCP, pode direcionar chamadas através do endpoint MCP da Zyla. Forneça sua chave de API na URL do MCP e faça seu agente chamar os endpoints documentados em seu nome.
- Endpoint MCP: MCP
- Uso: configure sua ferramenta com o endpoint MCP e sua chave. A partir do agente, chame os mesmos endpoints da API de Categorização de Sites mostrados acima com os parâmetros necessários (url ou email) e o cabeçalho de Autorização.
Isso permite que você mantenha as etapas de categorização dentro de um fluxo de trabalho autônomo enquanto mantém uma única chave de API em todas as ferramentas do ecossistema Zyla. Explore mais APIs para seus agentes em zylalabs.com.
Solução de problemas e lista de verificação de produção
- Valide as entradas: certifique-se de que a url é uma URL absoluta formatada corretamente e que o e-mail é sintaticamente válido antes de enviar.
- Verifique o sucesso: verifique se o campo de sucesso é verdadeiro antes de ler arrays de categorias.
- Fallbacks: quando categorias estiver vazio ou nulo, decida sobre uma rota padrão (por exemplo, “Sem Categoria”).
- Timeouts/retries: defina timeouts do cliente e tente novamente de forma idempotente em erros de rede transitórios. Evite loops de tentativas que possam rapidamente consumir a cota.
- Registro: registre o nome da categoria e a confiança para ajudar na afinação e depuração futuras.
FAQ
Qual método de autenticação é necessário?
Use o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY em cada solicitação.
Posso categorizar um caminho completo (não apenas um domínio raiz)?
Sim, use o endpoint de URL (POST para https://zylalabs.com/api/12/website-categorization-api/48/url) com o parâmetro url.
Como faço para categorizar usuários por seus provedores de e-mail?
Use o endpoint de E-mail (POST para https://zylalabs.com/api/12/website-categorization-api/1989/email) com o parâmetro email. Analise domain.categories para a categoria primária e confiança.
Qual modelo de plano a Zyla usa?
Assinatura + cota. Esta API oferece um teste de 7 dias em sua página de listagem para que você possa avaliar rapidamente. Verifique a página da API para opções de acesso e preços atuais.
Quais campos são seguros para assumir que estão presentes?
Sempre verifique o sucesso. O array domain.categories, logo_url, social_media e os campos objects.company podem estar presentes, mas alguns valores podem ser nulos. Proteja-se contra campos ausentes.
Envie isso
Agora você tem exemplos de cURL e Python funcionando para a API de Categorização de Sites. Inscreva-se, pegue sua chave e comece a classificar URLs e domínios de e-mail hoje: Comece o teste de 7 dias na API de Categorização de Sites.
