API para estadísticas de tráfico del sitio

Necesitas estadísticas de tráfico del sitio confiables que puedas integrar en un panel o trabajo de enriquecimiento esta semana. Al final de esta guía, podrás solicitar métricas de tráfico (visitas, clasificaciones, fuentes y más) para cualquier dominio utilizando una única solicitud HTTP GET autenticada y conectarlo a tu código en minutos.

Qué devuelve esta API y por qué es útil

La API Traffic Metrics Explorer proporciona análisis web de alta señal para un dominio dado: visitas estimadas, compromiso (tasa de rebote, páginas por visita, tiempo en el sitio), clasificaciones globales/por país/categoría, cuotas de los principales países y mezcla de fuentes de tráfico. Los equipos la utilizan para:

• Enriquecer perfiles de empresas con estimaciones de visitas mensuales y clasificaciones.
• Priorizar leads de ventas según la escala de tráfico real y el patrón de crecimiento.
• Potenciar paneles de competidores con distribución por país y canales de adquisición.
• Restringir características (por ejemplo, niveles de socios) según niveles de tráfico demostrables.

Está disponible en Zyla API Hub, que ofrece una cuenta, una clave API y un modelo de suscripción a través de más de 10,000 APIs públicas. Puedes suscribirte una vez y llamar a través de categorías sin tener que manejar múltiples proveedores.

Comenzando en Zyla API Hub

Para obtener una clave API:

1. Abre la lista de APIs y comienza la prueba: Comienza la prueba de 7 días en la API Traffic Metrics Explorer.
2. Haz clic en Suscribirse (o Comenzar prueba gratuita cuando esté disponible). Recibirás una única clave API para todas tus APIs de Zyla.
3. Usa la clave a través del encabezado HTTP Authorization: Bearer YOUR_API_KEY.

La facturación en Zyla es por suscripción + cuota, no por llamada. No hay Plan Gratuito; consulta la página de la API para opciones de acceso y precios actuales.

Endpoint que llamarás

La API expone un endpoint para métricas de tráfico. Acepta un único parámetro requerido y devuelve una carga estructurada con métricas de visitas y clasificaciones.

Estadísticas de tráfico del sitio

• Método: GET
• URL: https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats
• Parámetro de consulta:
  • domain (requerido): El dominio a analizar (por ejemplo, gmail.com).
• Auth: Authorization: Bearer YOUR_API_KEY

Solicitud cURL para copiar y pegar

Ejecuta esto tal cual, reemplazando YOUR_API_KEY con tu clave de Zyla. El parámetro de dominio es requerido.

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"

Ejemplo de respuesta oficial

A continuación se muestra el ejemplo de respuesta oficial. Úsalo para mapear los campos que leerás en tu integración.

{"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 clave que probablemente usarás:

• Engagments.Visits: visitas del mes actual (cadena numérica). Trátalo como un conteo entero.
• EstimatedMonthlyVisits: un mapa de YYYY-MM-01 a estimaciones de visitas mensuales. Útil para líneas de tendencia.
• GlobalRank.Rank, CountryRank.Rank: enteros de clasificación para global y país específico.
• TopCountryShares: lista de códigos de país con cuota de tráfico (fracción 0–1).
• TrafficSources: mezcla de canales (fracciones que suman aproximadamente 1).
• BounceRate, PagePerVisit, TimeOnSite: métricas de compromiso. La tasa de rebote y otros valores se representan como cadenas; analiza a numérico para cálculos.

Ejemplo en Python: obtener y normalizar métricas clave

Este script llama al mismo endpoint, analiza cadenas numéricas y imprime un resumen compacto. Reemplaza YOUR_API_KEY con tu clave y establece el dominio que necesitas.

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
})

Consejos de implementación que ahorran tiempo

• Autenticación: siempre envía Authorization: Bearer YOUR_API_KEY. No pases claves API en la cadena de consulta.
• Análisis numérico: varias métricas (por ejemplo, BounceRate, PagePerVisit, TimeOnSite, Visits) pueden ser cadenas. Convierte a float/int antes de matemáticas o clasificación.
• Unidades: TimeOnSite son segundos; TrafficSources y TopCountryShares son cuotas fraccionarias (0–1). BounceRate es una fracción (0–1).
• Tendencias: las claves de EstimatedMonthlyVisits son fechas ISO de inicio de mes (YYYY-MM-01). Ordena las claves y traza en lugar de asumir un orden consecutivo.
• Cacheo: las métricas de tráfico cambian mensualmente con actualizaciones incrementales; almacena en caché las respuestas por dominio para reducir la latencia y el uso de cuotas.
• Campos faltantes: no todos los dominios tendrán todas las clasificaciones o metadatos ricos. Siempre verifica objetos opcionales como GlobalCategoryRank.
• Manejo de errores: maneja respuestas no 200 y tiempos de espera. Los reintentos con retroceso ayudan en trabajos de enriquecimiento por lotes.

Casos de uso prácticos

Puntuación y enrutamiento de leads

Extrae Engagments.Visits y GlobalRank para cada dominio entrante, luego enruta al nivel de SDR correcto. Agrega TrafficSources.Search para detectar empresas impulsadas por SEO que pueden beneficiarse de asociaciones de contenido.

Planificación de expansión de mercado

Utiliza TopCountryShares para calcular los 3 principales países por cuota para sitios de competidores. Alimenta CountryRank en un mapa de calor para resaltar regiones fuertes vs. débiles.

Evaluación de socios

Verifica los umbrales mínimos de tráfico y la calidad del compromiso (PagePerVisit, BounceRate) antes de aprobar solicitudes de co-marketing o afiliación.

Estrategia de contenido

Realiza un seguimiento de la tendencia de EstimatedMonthlyVisits para tu blog y blogs competidores. Aplana un promedio móvil de 3 meses y alerta sobre caídas o ganancias del ≥15% mes a mes.

Llamadas desde agentes de IA a través de MCP

Si trabajas dentro de Claude Code, Cursor, Windsurf, o otro cliente compatible con MCP, puedes conectar esta API a tu agente apuntando al endpoint MCP de Zyla. El mismo encabezado de autorización y parámetro de dominio se aplican; el agente emitirá la solicitud GET en tu nombre.

• Endpoint MCP: MCP
• Pasa tu clave Zyla una vez; tu agente podrá llamar al endpoint de la API Traffic Metrics Explorer usando esa credencial.
• Usa la misma URL y parámetro de consulta mostrados arriba; los agentes generalmente te permiten definir una herramienta que realiza el GET con el dominio proporcionado en tiempo de ejecución.

Hoja de trucos de mapeo campo por campo

• SiteName, Title, Description: identificadores y etiquetas legibles por humanos para la interfaz de usuario.
• Engagments:
  • Month, Year: cadenas que representan el período de agregación actual.
  • Visits: estimación de visitas del mes actual.
  • PagePerVisit, BounceRate, TimeOnSite: señales de calidad de compromiso.
• EstimatedMonthlyVisits: visitas históricas claveadas por fecha de inicio de mes para gráficos de series temporales.
• GlobalRank, CountryRank, CategoryRank: contextos de clasificación para widgets de comparación.
• TopCountryShares: desglose para gráficos de mezcla geográfica o lógica de segmentación.
• TrafficSources: canales de adquisición; los valores son cuotas fraccionarias.

Lista de verificación completa de cableado

1. Suscríbete en la lista de la API y obtén tu clave de Zyla API Hub.
2. Llama a GET https://zylalabs.com/api/5510/traffic-metrics-explorer-api/7147/site-traffic-stats con el dominio y tu encabezado de autorización.
3. Analiza cadenas numéricas a números, almacena JSON sin procesar para auditoría.
4. Almacena en caché por dominio durante 24 horas (o tu ventana SLA) para minimizar las solicitudes repetidas.
5. Construye componentes de interfaz de usuario:
   • Título: visitas (mes actual), clasificación global.
   • Tendencia: gráfico de líneas de EstimatedMonthlyVisits.
   • Desglose: gráficos de pastel de TopCountryShares y TrafficSources.
   • Calidad: insignias de BounceRate, PagePerVisit, TimeOnSite.

FAQ

¿Qué autenticación se requiere?
Envía Authorization: Bearer YOUR_API_KEY en el encabezado para cada solicitud.

¿Qué parámetros son requeridos?
El endpoint requiere un parámetro de consulta: domain. Ejemplo: ?domain=gmail.com.

¿Con qué frecuencia se actualizan las métricas?
El tráfico y las clasificaciones son agregados mensuales con actualizaciones periódicas. Para la mayoría de las aplicaciones, el almacenamiento en caché diario o semanal por dominio es suficiente.

¿Puedo obtener datos históricos?
Sí, a través del objeto EstimatedMonthlyVisits, que mapea fechas de inicio de mes (YYYY-MM-01) a conteos de visitas.

¿Hay un plan gratuito?
No hay Plan Gratuito. Hay una prueba de 7 días disponible en la página del artículo; consulta la lista para opciones de acceso y precios actuales.

¿Listo para lanzar? Comienza tu prueba de 7 días, obtén tu clave API y conecta métricas de tráfico a tu producto hoy: Comienza la prueba de 7 días en la API Traffic Metrics Explorer.

Respuesta oficial de la 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…

Respuesta oficial de la 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…