API para fonte de tráfego e visão geral

Você precisa de dados confiáveis sobre a fonte de tráfego e engajamento para um domínio, e precisa disso esta semana. Ao final deste artigo, você saberá exatamente qual endpoint retorna métricas de fonte de tráfego e visão geral, como chamá-lo, como analisar os campos que você se importa e como executar a mesma chamada de um agente de IA via MCP—usando uma chave de API do Zyla API Hub.

O que esta API entrega e quando usá-la

A API de Tráfego do Site no Zyla API Hub retorna inteligência de tráfego web em nível de domínio: principais países por participação de tráfego, métricas de engajamento e uma visão geral que inclui um título e descrição para o site. Um endpoint acompanhante fornece os países suportados e códigos ISO, o que é útil quando você deseja mapear códigos de países numéricos ou alfabéticos em rótulos legíveis em seu produto.

Usos típicos:

• Painéis de atribuição de marketing que precisam das participações dos 5 principais países e métricas de engajamento.
• Classificação de leads de vendas com base em padrões de tráfego de domínio e estimativas de visitas mensais.
• Ferramentas de conteúdo ou SEO que anotam domínios com contexto de tráfego e metadados básicos.

Tudo funciona sob uma conta Zyla e uma chave de API; você pode chamar qualquer API do catálogo do Zyla API Hub (10.000+ APIs) usando a mesma chave e um modelo de assinatura + cota.

Começando no Zyla API Hub

Abra a página da API de Tráfego do Site no Zyla, clique em Assinar ou Iniciar teste de 7 dias e obtenha sua chave de API. A autenticação é um token bearer enviado como Authorization: Bearer YOUR_API_KEY. A cobrança é por assinatura + cota (não por chamada). Para a primeira API, espere um teste de 7 dias ou 50 solicitações; verifique a página da API para opções de acesso e preços atuais.

Comece aqui: Iniciar teste de 7 dias na API de Tráfego do Site. Você sempre pode explorar mais APIs na página inicial do Zyla API Hub.

Endpoints que você usará

1) Fonte de Tráfego e Visão Geral

Método: GET

URL: https://zylalabs.com/api/29/site-traffic-api/93/traffic-source-and-overview

O que retorna: status de tráfego por país (top 5), contexto da fonte de tráfego e informações de engajamento para um domínio específico. Passe o domínio sem protocolo ou “www”.

• Parâmetro de consulta obrigatório: domínio (exemplo: google.com)

cURL oficial:

curl -s -X GET "https://zylalabs.com/api/29/site-traffic-api/1372/countries-list" \
-H "Authorization: Bearer YOUR_API_KEY"

Exemplo de resposta oficial:

{
"Version": 1,
"SiteName": "google.com",
"Description": "Saiba mais sobre o Programa de Editores Certificados. Nossos especialistas em software de publicação ajudarão você a maximizar a receita e expandir seus negócios.",
"TopCountryShares": [
{
"Country": 840,
"CountryCode": "US",
"Value": 0.23679350972974017
},
{
"Country": 392,
"CountryCode": "JP",
"Value": 0.059428140900848324
},
{
"Country": 356,
"CountryCode": "IN",
"Value": 0.05710248670449797
},
{
"Country": 76,
"CountryCode": "BR",
"Value": 0.049777326688909565
},
{
"Country": 826,
"CountryCode": "GB",
"Value": 0.03518837304351638
}
],
"Title": "Google Pesquisa Avançada",
"Engagments": {
"BounceRate": "0.28352824215831807",
"Month": "6",
"Year": "2026",
"PagePerVisit": "8.695346223748027",
"Visits": "84940150026",
"TimeOnSite": "605.4395199614316"
},
"EstimatedMonthlyVisits": {
"2026-04-01": 84751050692,…

Campos para prestar atenção:

• SiteName, Title, Description: metadados rápidos que você pode exibir na interface do usuário.
• TopCountryShares: cinco principais países por participação de tráfego. Inclui País numérico, Código do País de duas letras e Valor fracionário (participação).
• Engagments: métricas de engajamento para o mês e ano no payload, incluindo BounceRate, PagePerVisit, Visits e TimeOnSite.
• EstimatedMonthlyVisits: chaves de data (YYYY-MM-01) com totais de visitas.

2) Lista de Países

Método: GET

URL: https://zylalabs.com/api/29/site-traffic-api/1372/countries-list

O que retorna: uma lista de países suportados e códigos. Útil para mapear os valores Country e CountryCode retornados pela visão geral de tráfego para nomes e regiões amigáveis para exibição.

cURL oficial:

Exemplo de resposta oficial:

[{"name":"Afghanistan","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"Asia","sub-region":"Southern Asia","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"Åland Islands","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"Europe","sub-region":"Northern Europe","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"Albania","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Algeria","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"Africa","sub-region":"Northern Africa","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"American Samoa","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"Oceania","sub-region":"Polynesia","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"Andorra","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"Europe","sub-region":"Southern Europe","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Angola","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"Africa","sub-region":"Sub-Saharan Africa","intermediate-region":"Middle Africa","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"Anguilla","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"Americas","sub-region":"Latin America and the Caribbean","intermediate-region":"Caribbean","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"Antarctica","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"Antígua e Barbuda","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"Américas","sub-region":"América Latina e Caribe","intermediate-region":"Caribe","region-code":"019","s…

Uso comum: construir um cache local indexado por alpha-2 ou código do país para enriquecer as linhas de TopCountryShares da visão geral de tráfego com nomes e regiões de países.

Exemplo de ponta a ponta: buscar a visão geral do tráfego de um domínio e mapear países

Abaixo está um exemplo mínimo em Python que:

1. Chama o endpoint de Fonte de Tráfego e Visão Geral com um domínio.
2. Chama o endpoint de Lista de Países uma vez e constrói uma tabela de pesquisa por código alpha-2.
3. Imprime uma tabela dos 5 principais países com nomes de países legíveis e participações.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
BASE = "https://zylalabs.com/api/29/site-traffic-api"

def get_overview(domain: str):
url = f"{BASE}/93/traffic-source-and-overview"
resp = requests.get(url, params={"domain": domain}, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
return resp.json()

def get_countries():
url = f"{BASE}/1372/countries-list"
resp = requests.get(url, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
return resp.json()

def build_country_lookup(countries):
# Mapear código alpha-2 para nome do país (ex: "US" -> "Estados Unidos da América")
lookup = {}
for c in countries:
alpha2 = c.get("alpha-2")
name = c.get("name")
if alpha2 and name:
lookup[alpha2] = name
return lookup

if __name__ == "__main__":
domain = "google.com"
overview = get_overview(domain)
countries = get_countries()
code_to_name = build_country_lookup(countries)

print(f"Site: {overview.get('SiteName')}")
print(f"Título: {overview.get('Title')}")
print(f"Descrição: {overview.get('Description')}")

print("\nTop 5 Países por Participação:")
for row in overview.get("TopCountryShares", []):
code = row.get("CountryCode")
share = row.get("Value")
name = code_to_name.get(code, code)
print(f"- {name} ({code}): {share}")

engagements = overview.get("Engagments", {})
print("\nEngajamentos:")
for k in ["Year", "Month", "Visits", "BounceRate", "PagePerVisit", "TimeOnSite"]:
if k in engagements:
print(f"{k}: {engagements[k]}")

Notas:

• A autenticação é via o cabeçalho Authorization: Bearer YOUR_API_KEY.
• Nenhum corpo de solicitação é necessário para esses endpoints GET.
• Considere armazenar em cache a Lista de Países por 24 horas ou mais; ela muda com pouca frequência e acelera seus fluxos.

Detalhes de implementação prática que economizam tempo

• Formato do domínio: passe apenas o domínio, sem protocolo ou “www” (ex: example.com).
• Tipos de dados: vários valores numéricos (ex: BounceRate, PagePerVisit) chegam como strings; analise conforme necessário na lógica do seu aplicativo.
• Participações de tráfego: TopCountryShares.Value é uma participação fracionária (ex: 0.23 = 23%). Multiplique por 100 para porcentagens na interface do usuário.
• Mapeamento de países: use CountryCode (alpha-2) com a Lista de Países para renderizar nomes de exibição sem codificação rígida.
• Cache: Recomendado para EstimatedMonthlyVisits e Lista de Países para reduzir a latência e permanecer dentro da sua cota de assinatura.
• Erros: trate códigos não 2xx exibindo uma mensagem clara para o usuário (domínio inválido, cabeçalho de autorização ausente, etc.).

Casos de uso do mundo real

Enriquecimento de leads dentro de um CRM

Quando um novo lead inclui um site, chame o endpoint de Fonte de Tráfego e Visão Geral para buscar TopCountryShares e exibir os principais mercados para o público desse lead. Combine com Visitas e PagePerVisit de Engagments para priorizar o contato.

Painéis de atribuição

Para cada domínio que você rastreia (ex: referências ou parceiros), extraia e armazene em cache EstimatedMonthlyVisits indexadas por mês. Use TopCountryShares para detalhar as contribuições por geografia em barras empilhadas ou mapas coropléticos.

Planejamento de SEO e conteúdo

Enriqueça os resultados SERP ou listas de concorrentes com Título e Descrição para uma visão geral rápida, e exiba BounceRate ou PagePerVisit para destacar oportunidades de melhorias de conteúdo.

Chamando a API de um agente de IA (MCP)

Se você está automatizando via Claude Code, Cursor, Windsurf ou qualquer cliente compatível com MCP, você pode direcionar chamadas através do gateway MCP do Zyla. Configure sua ferramenta para usar o endpoint MCP e forneça sua chave de API:

MCP

Em tempo de execução, seu agente pode direcionar os mesmos URLs do Hub mostrados acima (incluindo o parâmetro de consulta domínio para o endpoint de Fonte de Tráfego e Visão Geral). Mantenha o cabeçalho de Autorização como Bearer YOUR_API_KEY, ou siga a configuração do seu cliente MCP para passar credenciais. Como você está em um plano de assinatura + cota, projete prompts para reutilizar resultados em cache em vez de re-chamar a rede a cada turno.

Lista de verificação de validação antes de enviar

• Solicitação GET autenticada com Authorization: Bearer YOUR_API_KEY.
• Para visão geral: inclua o parâmetro de consulta do domínio, sem protocolo e sem www.
• Analise JSON e converta campos numéricos em string onde necessário.
• Mapeie TopCountryShares.CountryCode para um nome legível via Lista de Países.
• Armazene em cache a Lista de Países e estimativas mensais para permanecer dentro da cota e melhorar a latência.

Perguntas frequentes

A API aceita URLs completas ou apenas domínios?
Apenas domínios sem protocolo e sem “www” (ex: example.com) devem ser passados para o endpoint de Fonte de Tráfego e Visão Geral.

Como faço para autenticar?
Envie Authorization: Bearer YOUR_API_KEY no cabeçalho para cada solicitação.

Posso obter uma lista de países suportados?
Sim. Chame o endpoint de Lista de Países para receber países suportados e códigos ISO que você pode usar para enriquecer TopCountryShares do endpoint de visão geral.

Os campos numéricos são números ou strings?
Algumas métricas no objeto Engagments (ex: BounceRate, PagePerVisit, Visits, TimeOnSite) são retornadas como strings. Analise-as para números no seu código se precisar calcular ou formatá-las.

Quais são os limites e preços?
O Zyla usa um modelo de assinatura + cota (não por chamada). Para a primeira API, espere um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.

Pronto para implementar? Obtenha sua chave e comece a coletar dados de fonte de tráfego e engajamento hoje: Iniciar teste de 7 dias na API de Tráfego do Site. Explore mais categorias no Zyla API Hub quando estiver pronto para expandir sua integração.

Resposta oficial da API

[{"name":"Afeganistão","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"Ásia","sub-region":"Ásia Meridional","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"Ilhas Åland","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"Europa","sub-region":"Europa Setentrional","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"Albânia","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"Europa","sub-region":"Europa Meridional","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Argélia","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"África","sub-region":"África Setentrional","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"Samoa Americana","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"Oceania","sub-region":"Polinésia","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"Andorra","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"Europa","sub-region":"Europa Meridional","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Angola","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"África","sub-region":"África Subsaariana","intermediate-region":"África Central","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"Anguilla","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"Américas","sub-region":"América Latina e Caribe","intermediate-region":"Caribe","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"Antártica","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"Antígua e Barbuda","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"Américas","sub-region":"América Latina e Caribe","intermediate-region":"Caribe","region-code":"019","s…

Resposta oficial da API

[{"name":"Afeganistão","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"Ásia","sub-region":"Ásia Meridional","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"Ilhas Åland","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"Europa","sub-region":"Europa Setentrional","intermediate-region":"","region-code":"150","sub-region-code":"154","intermediate-region-code":""},{"name":"Albânia","alpha-2":"AL","alpha-3":"ALB","country-code":"008","iso_3166-2":"ISO 3166-2:AL","region":"Europa","sub-region":"Europa Meridional","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Argélia","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"África","sub-region":"África Setentrional","intermediate-region":"","region-code":"002","sub-region-code":"015","intermediate-region-code":""},{"name":"Samoa Americana","alpha-2":"AS","alpha-3":"ASM","country-code":"016","iso_3166-2":"ISO 3166-2:AS","region":"Oceania","sub-region":"Polinésia","intermediate-region":"","region-code":"009","sub-region-code":"061","intermediate-region-code":""},{"name":"Andorra","alpha-2":"AD","alpha-3":"AND","country-code":"020","iso_3166-2":"ISO 3166-2:AD","region":"Europa","sub-region":"Europa Meridional","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Angola","alpha-2":"AO","alpha-3":"AGO","country-code":"024","iso_3166-2":"ISO 3166-2:AO","region":"África","sub-region":"África Subsaariana","intermediate-region":"África Central","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"Anguilla","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"Américas","sub-region":"América Latina e Caribe","intermediate-region":"Caribe","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"Antártica","alpha-2":"AQ","alpha-3":"ATA","country-code":"010","iso_3166-2":"ISO 3166-2:AQ","region":"","sub-region":"","intermediate-region":"","region-code":"","sub-region-code":"","intermediate-region-code":""},{"name":"Antígua e Barbuda","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"Américas","sub-region":"América Latina e Caribe","intermediate-region":"Caribe","region-code":"019","s…