Como Usar a API de Categorização de Websites

Seu PM pediu por "categorização automática de cada website e domínio de email por categoria" e você precisa de algo que possa ser entregue esta semana. Ao final deste artigo, você será capaz de enviar uma URL completa ou um endereço de email para a API de Categorização de Websites no Zyla API Hub e receber de volta categorias concretas (com confiança), uma URL de logo e metadados relacionados que você pode integrar diretamente em seu enriquecimento, roteamento ou pipeline de análises.

O que esta API faz e quando usá-la

A API de Categorização de Websites classifica um caminho de URL (não apenas o domínio raiz) ou um domínio de email e retorna categorias com pontuações de confiança, além de extras úteis como uma URL de logo e links sociais quando disponíveis. Integrações típicas incluem enriquecimento de CRM, roteamento de leads por indústria, moderação de conteúdo e segmentação de análises.

Ilustração: Como Usar a API de Categorização de Websites

Você pode:

Categorizar uma URL completa (por exemplo, páginas de destino, postagens de blog, URLs de produtos).
Categorizar um domínio de email a partir de um registro de contato para inferir o contexto da organização.

A API está disponível no Zyla API Hub, que fornece uma conta, uma chave de API e um modelo de assinatura mais cota em milhares de APIs. Verifique a página da API para opções de acesso e preços atuais.

Começando no Zyla API Hub

Abra a listagem da API de Categorização de Websites, clique em Assinar ou Iniciar Teste Gratuito quando disponível, e copie sua chave de API. A autenticação é um único cabeçalho HTTP: Authorization: Bearer YOUR_API_KEY.

Comece aqui: Iniciar teste de 7 dias na API de Categorização de Websites. A Zyla utiliza assinatura + cota (não pagamento por chamada). Para uma primeira integração, você normalmente verá um teste de 7 dias ou uma cota de requisições limitada; verifique a listagem para a opção atual.

Endpoints que você pode chamar

Esta API expõe dois endpoints POST no Zyla API Hub. Ambos requerem o cabeçalho de Autorização e aceitam parâmetros de formulário codificados em URL.

1) URL: categorizar um caminho de URL completo

Use isso quando você precisa classificar uma página específica, não apenas o domínio raiz.

Método: POST
URL de Requisição: https://zylalabs.com/api/12/website-categorization-api/48/url
Parâmetro requerido: url (a URL completa que você deseja categorizar)

Curl oficial (copie/cole como está e substitua 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"

Resposta JSON oficial de exemplo:

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

O que você realmente usará:

domain.categories: lista de objetos de categoria. Cada objeto inclui:
- name: o caminho da taxonomia (por exemplo, “/Internet & Telecom/Email & Messaging/Email”).
- confidence: pontuação numérica indicando a confiança na classificação.
- identificadores IAB quando disponíveis (por exemplo, IAB19-15, IAB-623-619).
domain.logo_url: útil para badges de UI ou cartões de CRM.
domain.social_media: URLs podem estar presentes ou nulas; trate verificações nulas.
objects.company: metadados como nome, campos de localização, employeesRange, revenue, tags e indicadores de stack tecnológico quando disponíveis.
success: booleano para confirmar uma categorização bem-sucedida.

Exemplo em Python: categorizar uma URL e escolher a categoria principal

Este exemplo envia dados codificados em formulário com o cabeçalho de Autorização, depois obtém o nome da categoria principal e a confiança. Ele também demonstra acesso 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}",
}
# O endpoint espera dados de formulário codificados em URL
data = {
"url": target_url
}
resp = requests.post(URL, headers=headers, data=data, timeout=30)
resp.raise_for_status()
payload = resp.json()

# Leia campos com segurança
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) Email: categorizar por domínio de email

Use isso quando você tem um endereço de email e deseja inferir a categoria do domínio. Isso é conveniente em CRM ou automação de marketing, onde o email é o identificador principal.

Método: POST
URL de Requisição: https://zylalabs.com/api/12/website-categorization-api/1989/email
Parâmetro requerido: email (o endereço de email cujo domínio você deseja categorizar)

Curl oficial:

Resposta de exemplo (truncada conforme fornecido na listagem):

Observe que a estrutura ainda inclui domain.categories, e os campos podem ser nulos quando os dados não estão disponíveis. Sempre verifique nulos.

Detalhes de implementação que economizam tempo

Autenticação: inclua Authorization: Bearer YOUR_API_KEY em cada requisição.
Codificação: ambos os endpoints esperam parâmetros de formulário codificados em URL (como mostrado por --data-urlencode no curl).
Corpo da requisição: envie apenas o parâmetro requerido para cada endpoint:
- O endpoint de URL requer: url
- O endpoint de email requer: email
Não adicione chaves extras.
Nullabilidade: muitos campos (por exemplo, URLs de redes sociais ou metadados da empresa) podem ser nulos. Proteja seus acessores.
Cache: se você categoriza repetidamente os mesmos domínios/URLs, adicione um cache em nível de aplicativo com chave pela URL normalizada ou domínio de email para reduzir chamadas e latência.
Batching: a listagem expõe endpoints de item único. Se você precisar de throughput em lote, execute trabalhadores concorrentes do lado do cliente enquanto respeita sua cota de assinatura.
Tratamento de erros: verifique os códigos de status HTTP e o booleano de sucesso na resposta. Se um campo estiver ausente, trate-o como indisponível em vez de um erro.
Consistência: uma URL de página pode produzir uma categoria mais específica do que seu domínio raiz. Prefira o endpoint de URL para fluxos de trabalho por página.

Casos de uso práticos que você pode construir esta semana

Roteamento de leads: categorize a URL do website submetido em seu formulário de inscrição e atribua à fila de vendas correta com base na indústria/categoria.
Enriquecimento de ESP/CRM: quando você só tem um email, use o endpoint de Email para inferir a categoria do domínio e auto-categorizar contatos para fluxos de integração.
Segmentação e exclusões de anúncios: classifique URLs de conteúdo para garantir que campanhas sejam executadas apenas contra categorias permitidas.
Análises de conteúdo: categorize links de saída em seu produto ou blog por categoria para construir um painel de engajamento em nível de categoria.
Polimento de UI: exiba a logo_url ao lado de uma empresa ou pré-visualização de link em seu aplicativo.

Chame a API de agentes de IA via MCP

Você também pode acionar esses mesmos endpoints de um cliente compatível com MCP (por exemplo, Claude Code, Cursor, Windsurf) direcionando seu agente para o gateway MCP da Zyla. Forneça sua chave de API na configuração do cliente MCP e chame os mesmos endpoints do hub através de invocações de ferramentas. Veja MCP para detalhes de conexão. O gateway MCP usa sua chave de API Zyla e assinatura; os resultados correspondem às chamadas HTTP diretas mostradas acima.

Um fluxo de trabalho mínimo para entregar

Crie uma conta Zyla e assine a API na página de listagem. Copie sua chave de API.
Para entradas de URL (por exemplo, de formulários ou webhooks), POST para https://zylalabs.com/api/12/website-categorization-api/48/url com url definido para a URL completa da página.
Para entradas de email (por exemplo, de eventos de CRM), POST para https://zylalabs.com/api/12/website-categorization-api/1989/email com email definido para o email do usuário.
Leia domain.categories[0].name e domain.categories[0].confidence; armazene-os em seu banco de dados junto com logo_url.
Adicione verificações nulas e cache simples para URLs/domínios repetidos. Monitore sua cota de assinatura na Zyla.

FAQ

Que autenticação a API usa?
Envie Authorization: Bearer YOUR_API_KEY em cada requisição.

Posso categorizar uma página específica, não apenas o domínio inicial?
Sim. Use o endpoint de URL em https://zylalabs.com/api/12/website-categorization-api/48/url e passe o caminho completo da URL.

Em quais campos devo confiar para roteamento?
Leia domain.categories, especialmente o nome e a confiança do primeiro item. Mantenha um caminho seguro contra nulos para campos opcionais como logo_url ou social_media.

Há um plano gratuito?
Esta API usa assinatura + cota e não oferece um Plano Gratuito. Verifique a listagem para opções de acesso atuais; normalmente você verá um teste de 7 dias ou uma cota de requisições limitada para avaliação.

Como integro isso com meu agente de codificação de IA?
Conecte seu agente ao gateway MCP da Zyla e invoque os mesmos endpoints como ferramentas. Consulte o link MCP acima para detalhes de configuração.

Pronto para categorizar tráfego real e entregar sua integração? Comece sua avaliação aqui: Iniciar teste de 7 dias na API de Categorização de Websites. Sua assinatura funciona no Zyla API Hub com uma única chave de API que você também pode usar via agentes habilitados para MCP.