API para estatísticas de tráfego do site

Você precisa de estatísticas de tráfego do site confiáveis que você possa inserir em um painel ou trabalho de enriquecimento esta semana. Ao final deste guia, você será capaz de solicitar métricas de tráfego (visitas, classificações, fontes e mais) para qualquer domínio usando uma única solicitação HTTP GET autenticada e integrá-la ao seu código em minutos.

O que esta API retorna e por que é útil

A API Traffic Metrics Explorer fornece análises web de alto sinal para um determinado domínio: visitas estimadas, engajamento (taxa de rejeição, páginas por visita, tempo no site), classificações globais/país/categoria, principais participações de países e mix de fontes de tráfego. As equipes a utilizam para:

• Enriquecer perfis de empresas com estimativas mensais de visitas e classificações.
• Priorizar leads de vendas com base na escala de tráfego real e no padrão de crescimento.
• Potencializar painéis de concorrentes com distribuição por país e canais de aquisição.
• Restringir recursos (por exemplo, níveis de parceiros) por níveis de tráfego demonstráveis.

Está disponível no Zyla API Hub, que oferece uma conta, uma chave de API e um modelo de assinatura em mais de 10.000 APIs públicas. Você pode se inscrever uma vez e chamar entre categorias sem precisar gerenciar vários provedores.

Começando no Zyla API Hub

Para obter uma chave de API:

1. Abra a lista de APIs e inicie o teste: Iniciar teste de 7 dias na API Traffic Metrics Explorer.
2. Clique em Inscrever-se (ou Iniciar Teste Gratuito quando disponível). Você receberá uma única chave de API para todas as suas APIs Zyla.
3. Use a chave via cabeçalho HTTP Authorization: Bearer YOUR_API_KEY.

A cobrança no Zyla é por assinatura + cota, não por chamada. Não há Plano Gratuito; verifique a página da API para opções de acesso e preços atuais.

Endpoint que você chamará

A API expõe um endpoint para métricas de tráfego. Ele aceita um único parâmetro obrigatório e retorna um payload estruturado com métricas de visita e classificação.

Estatísticas de Tráfego do Site

• Método: GET
• URL: https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats
• Parâmetro de consulta:
  • domain (obrigatório): O domínio a ser analisado (por exemplo, gmail.com).
• Auth: Authorization: Bearer YOUR_API_KEY

Solicitação cURL para copiar e colar

Execute isso como está, substituindo YOUR_API_KEY pela sua chave do Zyla. O parâmetro de domínio é obrigatório.

curl -s -X GET "https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats?domain=gmail.com" \
-H "Authorization: Bearer YOUR_API_KEY"

Exemplo de resposta oficial

Abaixo está o exemplo de resposta oficial. Use-o para mapear os campos que você lerá em sua integração.

{"Version":1,"SiteName":"decorsystem.com.pl","Description":"sztukateria styropianowa wewnętrzna - produkujemy listwy dekoracyjne, listwy sufitowe, listwy ozdobne ścienne, przypodłogowe i inne elementy do wnętrz","TopCountryShares":[{"Country":616,"CountryCode":"PL","Value":0.9719507540741068},{"Country":276,"CountryCode":"DE","Value":0.011927008465685628},{"Country":826,"CountryCode":"GB","Value":0.010493205200990377},{"Country":528,"CountryCode":"NL","Value":0.005629032259217371}],"Title":"sztukateria ścienna, styropianowa, ozdobna, dekoracyjna","Engagments":{"BounceRate":"0.5099347930295581","Month":"11","Year":"2024","PagePerVisit":"3.527907956431343","Visits":"122728","TimeOnSite":"142.85020306566452"},"EstimatedMonthlyVisits":{"2024-09-01":133456,"2024-10-01":145713,"2024-11-01":122728},"GlobalRank":{"Rank":293452},"CountryRank":{"Country":616,"CountryCode":"PL","Rank":5641},"CategoryRank":{"Rank":"58","Category":"Home_and_Garden/Home_and_Garden"},"GlobalCategoryRank":null,"IsSmall":false,"Policy":0,"TrafficSources":{"Social":0.014974693477023336,"Paid Referrals":0.026707830225292793,"Mail":0.0038130298508330866,"Referrals":0.05137472542922812,"Search":0.41403432760255826,"Direct":0.4890953934014385},"Category":"home_and_garden/home_and_garden","LargeScreenshot":"https://site-images.similarcdn.com/image?url=decorsystem.com.pl&t=1&s=1&h=fd4f65c1308020880a5b57e8ad5b067e3df8691fc01c2428322ca684183216e4","IsDataFromGa":false,"Countries":[{"Code":"AF","UrlCode":"afghanistan","Name":"Afghanistan"},{"Code":"AX","UrlCode":"land-islands","Name":"Åland Islands"},{"Code":"AL","UrlCode":"albania","Name":"Albania"},{"Code":"DZ","UrlCode":"algeria","Name":"Algeria"},{"Code":"AS","UrlCode":"american-samoa","Name":"American Samoa"},{"Code":"AD","UrlCode":"andorra","Name":"Andorra"},{"Code":"AO","UrlCode":"angola","Name":"Angola"},{"Code":"AI","UrlCode":"anguilla","Name":"Anguilla"},{"Code":"AQ","UrlCode":"antarctica","Name":"Antarctica"},{"Code":"AG","UrlCode":"antigua-and-barbuda","Name":"Antigua and Barbuda"},{"Code":"AR","UrlCode":"argentina","Name":"Argentina"},{"Code":"AM","UrlCode":"armenia","Name":"Armenia"},{"Code":"AW","UrlCode":"aruba","Name":"Aruba"},{"Code":"AU","UrlCode":"australia","Name":"Australia"},{"Code":"AT","UrlCode":"austria","Name":"Austria"},{"Code":"AZ","UrlCode":"azerbaijan","Name":"Azerbaijan"},{"Code":"BS","UrlCode":"bahamas","Name":"Bahamas"},{"Code":"BH","UrlCode":"bahrain","Name":"Bahrain"},{"Code":"BD","UrlCode":"bangladesh","Name":"Ba…

Campos principais que você provavelmente usará:

• Engagments.Visits: visitas do mês atual (string numérica). Trate como uma contagem inteira.
• EstimatedMonthlyVisits: um mapa de YYYY-MM-01 para estimativas mensais de visitas. Útil para linhas de tendência.
• GlobalRank.Rank, CountryRank.Rank: inteiros de classificação para global e país específico.
• TopCountryShares: lista de códigos de países com participação de tráfego (fração de 0–1).
• TrafficSources: mix de canais (frações que somam aproximadamente 1).
• BounceRate, PagePerVisit, TimeOnSite: métricas de engajamento. A taxa de rejeição e outros valores são representados como strings; analise para numérico para cálculo.

Exemplo em Python: buscar e normalizar métricas principais

Este script chama o mesmo endpoint, analisa strings numéricas e imprime um resumo compacto. Substitua YOUR_API_KEY pela sua chave e defina o domínio que você precisa.

import os
import requests

API_KEY = os.getenv("Zyla_API_Key", "YOUR_API_KEY")
DOMAIN = "gmail.com"

url = "https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats"
params = {"domain": DOMAIN}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data = resp.json()

# Helper to coerce string numbers to float
def to_float(x):
try:
return float(x)
except Exception:
return None

# Extract core fields safely
site = data.get("SiteName")
desc = data.get("Description")
eng = data.get("Engagments", {})
visits = eng.get("Visits")
bounce = to_float(eng.get("BounceRate"))
ppv = to_float(eng.get("PagePerVisit"))
tos = to_float(eng.get("TimeOnSite")) # seconds
rank_global = (data.get("GlobalRank") or {}).get("Rank")
country_rank = (data.get("CountryRank") or {}).get("Rank")
country_code = (data.get("CountryRank") or {}).get("CountryCode")

sources = data.get("TrafficSources", {})
search_share = sources.get("Search")
direct_share = sources.get("Direct")

trend = data.get("EstimatedMonthlyVisits", {})

print({
"domain": DOMAIN,
"site": site,
"visits_current_month": int(visits) if isinstance(visits, str) and visits.isdigit() else visits,
"bounce_rate": bounce, # 0-1
"pages_per_visit": ppv,
"avg_time_on_site_sec": tos,
"global_rank": rank_global,
"country_rank": {"code": country_code, "rank": country_rank},
"traffic_sources": {"search": search_share, "direct": direct_share},
"estimated_monthly_visits": trend
})

Dicas de implementação que economizam tempo

• Autenticação: sempre envie Authorization: Bearer YOUR_API_KEY. Não passe chaves de API na string de consulta.
• Análise numérica: várias métricas (por exemplo, BounceRate, PagePerVisit, TimeOnSite, Visits) podem ser strings. Converta para float/int antes de cálculos ou ordenação.
• Unidades: TimeOnSite é em segundos; TrafficSources e TopCountryShares são participações fracionárias (0–1). BounceRate é uma fração (0–1).
• Tendências: as chaves de EstimatedMonthlyVisits são datas ISO de início do mês (YYYY-MM-01). Classifique as chaves e plote em vez de assumir uma ordem consecutiva.
• Cache: as métricas de tráfego mudam em uma cadência mensal com atualizações incrementais; armazene em cache as respostas por domínio para reduzir a latência e o uso da cota.
• Campos ausentes: nem todos os domínios terão todas as classificações ou metadados ricos. Sempre verifique objetos opcionais como GlobalCategoryRank.
• Tratamento de erros: lide com respostas não 200 e timeouts. Retentativas com backoff ajudam em trabalhos de enriquecimento em lote.

Casos de uso práticos

Pontuação e roteamento de leads

Extraia Engagments.Visits e GlobalRank para cada domínio de entrada, depois roteie para o nível SDR correto. Adicione TrafficSources.Search para detectar empresas impulsionadas por SEO que podem se beneficiar de parcerias de conteúdo.

Planejamento de expansão de mercado

Use TopCountryShares para calcular os 3 principais países por participação para sites concorrentes. Alimente CountryRank em um mapa de calor para destacar regiões fortes vs. fracas.

Avaliação de parceiros

Verifique os limites mínimos de tráfego e a qualidade do engajamento (PagePerVisit, BounceRate) antes de aprovar solicitações de co-marketing ou afiliados.

Estratégia de conteúdo

Acompanhe a tendência de EstimatedMonthlyVisits para seu blog e blogs concorrentes. Achate uma média móvel de 3 meses e alerte sobre quedas ou ganhos de ≥15% mês a mês.

Chamando de agentes de IA via MCP

Se você trabalha dentro do Claude Code, Cursor, Windsurf ou outro cliente compatível com MCP, pode integrar esta API ao seu agente apontando para o endpoint MCP do Zyla. O mesmo cabeçalho de Autorização e parâmetro de domínio se aplicam; o agente emitirá a solicitação GET em seu nome.

• Endpoint MCP: MCP
• Passe sua chave Zyla uma vez; seu agente poderá então chamar o endpoint da API Traffic Metrics Explorer usando essa credencial.
• Use a mesma URL e parâmetro de consulta mostrados acima; os agentes geralmente permitem que você defina uma ferramenta que realiza o GET com o domínio fornecido em tempo de execução.

Folha de dicas de mapeamento campo a campo

• SiteName, Title, Description: identificadores e rótulos legíveis por humanos para a interface do usuário.
• Engagments:
  • Mês, Ano: strings representando o período de agregação atual.
  • Visitas: estimativa de visitas do mês atual.
  • PagePerVisit, BounceRate, TimeOnSite: sinais de qualidade de engajamento.
• EstimatedMonthlyVisits: visitas históricas indexadas por data de início do mês para gráficos de séries temporais.
• GlobalRank, CountryRank, CategoryRank: contextos de classificação para widgets de comparação.
• TopCountryShares: divisão para gráficos de pizza de mix geográfico ou lógica de segmentação.
• TrafficSources: canais de aquisição; os valores são participações fracionárias.

Lista de verificação completa de fiação

1. Inscreva-se na lista de APIs e obtenha sua chave no Zyla API Hub.
2. Chame GET https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats com domínio e seu cabeçalho de Autorização.
3. Analise strings numéricas para números, armazene JSON bruto para auditoria.
4. Armazene em cache por domínio por 24 horas (ou sua janela SLA) para minimizar buscas repetidas.
5. Construa componentes de interface do usuário:
   • Título: visitas (mês atual), classificação global.
   • Tendência: sparkline de EstimatedMonthlyVisits.
   • Divisões: gráficos de pizza de TopCountryShares e TrafficSources.
   • Qualidade: distintivos de BounceRate, PagePerVisit, TimeOnSite.

FAQ

Que autenticação é necessária?
Envie Authorization: Bearer YOUR_API_KEY no cabeçalho para cada solicitação.

Quais parâmetros são obrigatórios?
O endpoint requer um parâmetro de consulta: domain. Exemplo: ?domain=gmail.com.

Com que frequência as métricas são atualizadas?
Tráfego e classificações são agregados mensais com atualizações periódicas. Para a maioria dos aplicativos, o armazenamento em cache diário ou semanal por domínio é suficiente.

Posso obter dados históricos?
Sim, via objeto EstimatedMonthlyVisits, que mapeia datas de início do mês (YYYY-MM-01) para contagens de visitas.

Há um plano gratuito?
Não há Plano Gratuito. Um teste de 7 dias está disponível na página do item; verifique a lista para opções de acesso e preços atuais.

Pronto para enviar? Comece seu teste de 7 dias, obtenha sua chave de API e conecte as métricas de tráfego ao seu produto hoje: Iniciar teste de 7 dias na API Traffic Metrics Explorer.

Resposta oficial da API

{"Version":1,"SiteName":"decorsystem.com.pl","Description":"sztukateria styropianowa wewnętrzna - produkujemy listwy dekoracyjne, listwy sufitowe, listwy ozdobne ścienne, przypodłogowe i inne elementy do wnętrz","TopCountryShares":[{"Country":616,"CountryCode":"PL","Value":0.9719507540741068},{"Country":276,"CountryCode":"DE","Value":0.011927008465685628},{"Country":826,"CountryCode":"GB","Value":0.010493205200990377},{"Country":528,"CountryCode":"NL","Value":0.005629032259217371}],"Title":"sztukateria ścienna, styropianowa, ozdobna, dekoracyjna","Engagments":{"BounceRate":"0.5099347930295581","Month":"11","Year":"2024","PagePerVisit":"3.527907956431343","Visits":"122728","TimeOnSite":"142.85020306566452"},"EstimatedMonthlyVisits":{"2024-09-01":133456,"2024-10-01":145713,"2024-11-01":122728},"GlobalRank":{"Rank":293452},"CountryRank":{"Country":616,"CountryCode":"PL","Rank":5641},"CategoryRank":{"Rank":"58","Category":"Home_and_Garden/Home_and_Garden"},"GlobalCategoryRank":null,"IsSmall":false,"Policy":0,"TrafficSources":{"Social":0.014974693477023336,"Paid Referrals":0.026707830225292793,"Mail":0.0038130298508330866,"Referrals":0.05137472542922812,"Search":0.41403432760255826,"Direct":0.4890953934014385},"Category":"home_and_garden/home_and_garden","LargeScreenshot":"https://site-images.similarcdn.com/image?url=decorsystem.com.pl&t=1&s=1&h=fd4f65c1308020880a5b57e8ad5b067e3df8691fc01c2428322ca684183216e4","IsDataFromGa":false,"Countries":[{"Code":"AF","UrlCode":"afghanistan","Name":"Afghanistan"},{"Code":"AX","UrlCode":"land-islands","Name":"Åland Islands"},{"Code":"AL","UrlCode":"albania","Name":"Albania"},{"Code":"DZ","UrlCode":"algeria","Name":"Algeria"},{"Code":"AS","UrlCode":"american-samoa","Name":"American Samoa"},{"Code":"AD","UrlCode":"andorra","Name":"Andorra"},{"Code":"AO","UrlCode":"angola","Name":"Angola"},{"Code":"AI","UrlCode":"anguilla","Name":"Anguilla"},{"Code":"AQ","UrlCode":"antarctica","Name":"Antarctica"},{"Code":"AG","UrlCode":"antigua-and-barbuda","Name":"Antigua and Barbuda"},{"Code":"AR","UrlCode":"argentina","Name":"Argentina"},{"Code":"AM","UrlCode":"armenia","Name":"Armenia"},{"Code":"AW","UrlCode":"aruba","Name":"Aruba"},{"Code":"AU","UrlCode":"australia","Name":"Australia"},{"Code":"AT","UrlCode":"austria","Name":"Austria"},{"Code":"AZ","UrlCode":"azerbaijan","Name":"Azerbaijan"},{"Code":"BS","UrlCode":"bahamas","Name":"Bahamas"},{"Code":"BH","UrlCode":"bahrain","Name":"Bahrain"},{"Code":"BD","UrlCode":"bangladesh","Name":"Ba…

Resposta oficial da API

{"Version":1,"SiteName":"decorsystem.com.pl","Description":"sztukateria styropianowa wewnętrzna - produkujemy listwy dekoracyjne, listwy sufitowe, listwy ozdobne ścienne, przypodłogowe i inne elementy do wnętrz","TopCountryShares":[{"Country":616,"CountryCode":"PL","Value":0.9719507540741068},{"Country":276,"CountryCode":"DE","Value":0.011927008465685628},{"Country":826,"CountryCode":"GB","Value":0.010493205200990377},{"Country":528,"CountryCode":"NL","Value":0.005629032259217371}],"Title":"sztukateria ścienna, styropianowa, ozdobna, dekoracyjna","Engagments":{"BounceRate":"0.5099347930295581","Month":"11","Year":"2024","PagePerVisit":"3.527907956431343","Visits":"122728","TimeOnSite":"142.85020306566452"},"EstimatedMonthlyVisits":{"2024-09-01":133456,"2024-10-01":145713,"2024-11-01":122728},"GlobalRank":{"Rank":293452},"CountryRank":{"Country":616,"CountryCode":"PL","Rank":5641},"CategoryRank":{"Rank":"58","Category":"Home_and_Garden/Home_and_Garden"},"GlobalCategoryRank":null,"IsSmall":false,"Policy":0,"TrafficSources":{"Social":0.014974693477023336,"Paid Referrals":0.026707830225292793,"Mail":0.0038130298508330866,"Referrals":0.05137472542922812,"Search":0.41403432760255826,"Direct":0.4890953934014385},"Category":"home_and_garden/home_and_garden","LargeScreenshot":"https://site-images.similarcdn.com/image?url=decorsystem.com.pl&t=1&s=1&h=fd4f65c1308020880a5b57e8ad5b067e3df8691fc01c2428322ca684183216e4","IsDataFromGa":false,"Countries":[{"Code":"AF","UrlCode":"afghanistan","Name":"Afghanistan"},{"Code":"AX","UrlCode":"land-islands","Name":"Åland Islands"},{"Code":"AL","UrlCode":"albania","Name":"Albania"},{"Code":"DZ","UrlCode":"algeria","Name":"Algeria"},{"Code":"AS","UrlCode":"american-samoa","Name":"American Samoa"},{"Code":"AD","UrlCode":"andorra","Name":"Andorra"},{"Code":"AO","UrlCode":"angola","Name":"Angola"},{"Code":"AI","UrlCode":"anguilla","Name":"Anguilla"},{"Code":"AQ","UrlCode":"antarctica","Name":"Antarctica"},{"Code":"AG","UrlCode":"antigua-and-barbuda","Name":"Antigua and Barbuda"},{"Code":"AR","UrlCode":"argentina","Name":"Argentina"},{"Code":"AM","UrlCode":"armenia","Name":"Armenia"},{"Code":"AW","UrlCode":"aruba","Name":"Aruba"},{"Code":"AU","UrlCode":"australia","Name":"Australia"},{"Code":"AT","UrlCode":"austria","Name":"Austria"},{"Code":"AZ","UrlCode":"azerbaijan","Name":"Azerbaijan"},{"Code":"BS","UrlCode":"bahamas","Name":"Bahamas"},{"Code":"BH","UrlCode":"bahrain","Name":"Bahrain"},{"Code":"BD","UrlCode":"bangladesh","Name":"Ba…