Casos de uso para la API de tráfico del sitio

Sus partes interesadas quieren un panel que muestre de dónde proviene el tráfico, qué países son relevantes y cuán comprometidos están los visitantes. Al final de este artículo, usted enviará una integración que obtiene la cobertura por país y las fuentes de tráfico a nivel de dominio, los principales países y las métricas de compromiso utilizando la API de tráfico del sitio en Zyla API Hub.

Lo que esta API ofrece

La API de tráfico del sitio proporciona inteligencia de tráfico a nivel de dominio que puede integrar en análisis de productos, herramientas de SEO o flujos de trabajo de investigación competitiva. Usted pasa un dominio y recibe:

• Los 5 principales países por participación de tráfico (con identificadores numéricos de país y códigos ISO alpha-2).
• Métricas de compromiso, incluyendo tasa de rebote, páginas por visita, visitas y tiempo en el sitio.
• Metadatos del sitio a alto nivel (título, descripción).

También expone un directorio de países con códigos ISO y regiones para que pueda etiquetar o filtrar el tráfico específico de cada país con precisión en su interfaz de usuario o informes.

Comenzando en Zyla API Hub

Abra la lista de la API de tráfico del sitio en Zyla API Hub y suscríbase. Zyla proporciona una cuenta, una clave API y un modelo de suscripción + cuota a través de más de 10,000 APIs públicas. Para esta API, puede comenzar con una prueba de 7 días o 50 solicitudes; consulte la lista para conocer las opciones de acceso y precios actuales.

Una vez suscrito, recibirá una clave API. Todas las solicitudes a continuación utilizan:

• Encabezado: Authorization: Bearer YOUR_API_KEY
• Método HTTP: GET

Navegue por otras categorías o administre sus suscripciones en cualquier momento desde Zyla API Hub. Cuando esté listo para implementar, obtenga la prueba aquí: Comience la prueba de 7 días en la API de tráfico del sitio.

Puntos finales que utilizará

1) Lista de países

Reciba la lista de todos los países soportados y sus códigos. Estos códigos se referencian en las respuestas de análisis de tráfico para que pueda renderizar correctamente los nombres de los países y las regiones.

Método: GET

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

cURL

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

Respuesta de muestra 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":"Antigua and Barbuda","alpha-2":"AG","alpha-3":"ATG","country-code":"028","iso_3166-2":"ISO 3166-2:AG","region":"Americas","sub-region":"Latin America and the Caribbean","intermediate-region":"Caribbean","region-code":"019","s…

Cómo usarlo:

• Mapee los códigos ISO de dos letras de las respuestas de tráfico a nombres legibles utilizando el campo “alpha-2”.
• Agrupe o filtre por “región” y “sub-región” al construir resúmenes.
• Almacene este conjunto de datos localmente y actualícelo periódicamente para evitar búsquedas repetidas.

2) Fuente de tráfico y resumen

Proporcione un dominio (sin protocolo o “www”) para recuperar los 5 principales países por participación de tráfico y métricas de compromiso, además de metadatos del sitio a alto nivel.

Método: GET

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

Parámetro de consulta requerido:

• domain: el dominio que desea analizar (ejemplo: google.com)

cURL

La respuesta incluye campos como:

• SiteName, Title, Description
• TopCountryShares: array de objetos con Country, CountryCode, Value
• Engagments: BounceRate, PagePerVisit, Visits, TimeOnSite, Month, Year
• EstimatedMonthlyVisits: un objeto indexado por fechas (por ejemplo, “YYYY-MM-01”) que mapea a conteos de visitas

Nota: El punto final de Fuente de tráfico y resumen requiere solo el parámetro de dominio; no incluya protocolos o subdominios como “www”.

Código que puede pegar

Ejemplo en Python: obtener resumen de tráfico y resumir campos clave

Este fragmento llama al punto final de Fuente de tráfico y resumen para un solo dominio e imprime las participaciones de los países y las métricas de compromiso. Reemplace YOUR_API_KEY con su clave de Zyla.

import requests
from typing import Dict, Any

API_KEY = "YOUR_API_KEY"
DOMAIN = "google.com"

url = "https://zylalabs.com/api/29/site-traffic-api/93/traffic-source-and-overview"
params = {"domain": DOMAIN}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data: Dict[str, Any] = resp.json()

print("Site:", data.get("SiteName"))
print("Title:", data.get("Title"))
print("Description:", data.get("Description"))

eng = data.get("Engagments", {}) or {}
print("Engagement:")
print(" BounceRate:", eng.get("BounceRate"))
print(" PagePerVisit:", eng.get("PagePerVisit"))
print(" Visits:", eng.get("Visits"))
print(" TimeOnSite (seconds):", eng.get("TimeOnSite"))
print(" Period:", f'{eng.get("Year")}-{eng.get("Month")}')

top_countries = data.get("TopCountryShares", []) or []
print("\nTop Country Shares:")
for item in top_countries:
code = item.get("CountryCode")
share = item.get("Value")
print(f" {code}: {share}")

monthly = data.get("EstimatedMonthlyVisits", {}) or {}
# Tome la clave del último mes si está disponible, ordenada por clave (formato YYYY-MM-01)
if monthly:
latest_key = sorted(monthly.keys())[-1]
print("\nLatest Estimated Monthly Visits:")
print(f" {latest_key}: {monthly[latest_key]}")

Consejo: La respuesta contiene valores numéricos y algunos números codificados como cadenas (por ejemplo, tasa de rebote, visitas en Engagments). Si necesita matemáticas numéricas, convierta las cadenas a float o int antes de las agregaciones.

Casos de uso prácticos que puede enviar esta semana

• Desglose de tráfico consciente del país dentro de un panel de marketing: Llame a Fuente de tráfico y resumen, renderice TopCountryShares con nombres de países de la lista de países.
• Widget de monitoreo competitivo: Para una lista corta de dominios competidores, consulte el punto final en un horario y trace EstimatedMonthlyVisits a lo largo del tiempo.
• Análisis de oportunidades de SEO: Combine SiteName/Title/Description con PagePerVisit y BounceRate para priorizar dominios que valga la pena contactar o asociarse.
• Planificación territorial: Use la lista de países para etiquetar países con regiones y sumar la participación de tráfico por región, ayudando a los equipos de ventas a enfocar sus esfuerzos.
• Controles de salud de compromiso: Realice un seguimiento de TimeOnSite, PagePerVisit y BounceRate cada mes para alertar cuando el compromiso se desvíe más allá de un umbral.

Detalles de solicitud/respuesta que ahorran tiempo

• Autenticación: Use Authorization: Bearer YOUR_API_KEY en cada solicitud.
• Formato de dominio: Proporcione solo el dominio (por ejemplo, “example.com”). No incluya protocolo o “www”.
• Campos de período de tiempo: Engagments incluye Month y Year; las claves EstimatedMonthlyVisits parecen “YYYY-MM-01”. Almacene como cadenas o analice a fechas.
• Códigos de país: Las respuestas de tráfico incluyen Country (código numérico) y CountryCode (ISO alpha-2). Use la lista de países para mapear a nombres de países y regiones.
• Cacheo: Ambos puntos finales son GET; implemente caché del lado del cliente para reducir llamadas redundantes en paneles o páginas renderizadas por el servidor.
• Paginación: No aplicable en estos puntos finales; las respuestas son cargas completas para el dominio o conjunto de datos solicitados.
• Modelo de acceso: Suscripción + cuota. El uso por primera vez a menudo comienza con una prueba de 7 días o 50 solicitudes; consulte la lista para obtener detalles actuales.

Llamando a la API desde agentes de IA a través de MCP

Si ejecuta su flujo de trabajo en un cliente compatible con MCP, puede enrutar llamadas a través del punto final MCP de Zyla. Configure su agente para alcanzar:

Punto final: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

Esto permite que su agente de IA invoque los mismos puntos finales de la API de tráfico del sitio documentados anteriormente mientras centraliza la autenticación a través de su clave de Zyla. Para más información sobre MCP, consulte la página de MCP. Aún controla qué rutas de API llama su herramienta y cómo se renderizan los resultados en las salidas de su agente.

Ejemplo de flujo de trabajo de extremo a extremo

1. Obtenga la lista de países una vez y almacénela en caché por ETag o marca de tiempo en su aplicación, indexada por alpha-2.
2. Para cada dominio proporcionado por el usuario, llame a Fuente de tráfico y resumen con domain=example.com.
3. Una los TopCountryShares.CountryCode a su mapa de países en caché para etiquetas y regiones.
4. Renderice métricas de compromiso (BounceRate, PagePerVisit, Visits, TimeOnSite) junto con las participaciones de los países.
5. Si traza tendencias, indexe EstimatedMonthlyVisits por fecha analizada para asegurar un orden correcto.

Consejos de validación y QA

• Normalización de dominio: Minúsculas y elimine prefijos antes de llamar a la API para evitar duplicados.
• Manejo de números: Convierta los numéricos en cadenas en Engagments a tipos numéricos para aritmética, pero mantenga las cadenas sin procesar para visualización si necesita un formato exacto.
• Resúmenes regionales: Use la lista de países “región” y “sub-región” para agregar tráfico; mantenga un respaldo para campos de región vacíos (por ejemplo, Antártida).
• Resiliencia: Envuelva las llamadas con tiempos de espera y reintentos; trate el conjunto de datos como eventualmente consistente y almacene en caché los resultados recientes.

Por qué Zyla para enviar rápido

Con una cuenta y una clave API a través del catálogo, puede agregar análisis o enriquecimiento adyacente más tarde sin cambiar su modelo de autenticación. La facturación es suscripción + cuota, lo que simplifica el seguimiento de costos. Explore el catálogo en Zyla API Hub, luego suscríbase a la API de tráfico del sitio para obtener los conocimientos de tráfico exactos que necesita esta semana.

FAQ

¿Qué formato de parámetro espera el campo de dominio?
Use el dominio básico sin protocolo o “www”, por ejemplo: domain=example.com.

¿Cómo mapeo los códigos de país en TopCountryShares a nombres legibles?
Llame al punto final de la lista de países y únase al código alpha-2 (CountryCode en TopCountryShares) para mostrar el nombre del país y la región.

¿Existen puntos finales de paginación o por lotes?
Los puntos finales documentados son GET de llamada única sin paginación. Para el procesamiento por lotes, recorra su lista de dominios y almacene en caché los resultados.

¿Qué unidades de tiempo se utilizan en los datos de compromiso?
Engagments.TimeOnSite se expresa en segundos. BounceRate, PagePerVisit y Visits pueden estar codificados como cadenas; convierta a tipos numéricos si necesita cálculos. Month y Year indican el período de la instantánea de compromiso.

¿Cómo empiezo una prueba y obtengo una clave API?
Suscríbase en la página de listado para comenzar una prueba de 7 días o 50 solicitudes (consulte la página para obtener acceso actual). Su clave aparece en la consola de Zyla y se usa como Bearer YOUR_API_KEY en los encabezados.

¿Listo para construir? Suscríbase y comience a obtener inteligencia de tráfico ahora: Comience la prueba de 7 días en la API de tráfico del sitio.

Respuesta oficial de la API

[{"name":"Afganistán","alpha-2":"AF","alpha-3":"AFG","country-code":"004","iso_3166-2":"ISO 3166-2:AF","region":"Asia","sub-region":"Asia del Sur","intermediate-region":"","region-code":"142","sub-region-code":"034","intermediate-region-code":""},{"name":"Islas Åland","alpha-2":"AX","alpha-3":"ALA","country-code":"248","iso_3166-2":"ISO 3166-2:AX","region":"Europa","sub-region":"Europa del Norte","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":"Europa","sub-region":"Europa del Sur","intermediate-region":"","region-code":"150","sub-region-code":"039","intermediate-region-code":""},{"name":"Argelia","alpha-2":"DZ","alpha-3":"DZA","country-code":"012","iso_3166-2":"ISO 3166-2:DZ","region":"África","sub-region":"África del Norte","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":"Oceanía","sub-region":"Polinesia","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 del Sur","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 Subsahariana","intermediate-region":"África Central","region-code":"002","sub-region-code":"202","intermediate-region-code":"017"},{"name":"Anguila","alpha-2":"AI","alpha-3":"AIA","country-code":"660","iso_3166-2":"ISO 3166-2:AI","region":"Américas","sub-region":"América Latina y el Caribe","intermediate-region":"Caribe","region-code":"019","sub-region-code":"419","intermediate-region-code":"029"},{"name":"Antártida","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":"Antigua y 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 y el Caribe","intermediate-region":"Caribe","region-code":"019","s…