API de Análisis de Linkly

Exporte datos de clics e informes de tráfico de Linkly mediante programación usando nuestra API de Análisis.

Relacionado: API de Acortamiento de Enlaces | Webhooks

Antes de comenzar

Linkly genera solicitudes de API en la interfaz para que las copie y pegue en sus aplicaciones.

Ahorre tiempo y deje que nosotros hagamos el trabajo difícil. Nuestra API es completamente legible por máquinas.

Autorización

Necesitará su Clave de API e ID de Espacio de Trabajo. Puede obtener estos detalles desde dentro de Linkly.

API de informes de tráfico

Linkly produce automáticamente solicitudes de API para usted dentro de sus informes de tráfico.

Los informes de tráfico de Linkly crean automáticamente solicitudes de API para usted, basadas en los datos mostrados en la pantalla.

Estos enlaces incluyen su clave de API y son fáciles de personalizar y usar en sus propias aplicaciones.

Formatos de salida

La API de Análisis admite tres formatos de salida:

Modo pivote (formato de matriz)

Por defecto, la API devuelve datos de series temporales con una fila por fecha. Con el modo pivote, puede obtener el tráfico de todos sus enlaces en una única solicitud como una matriz.

Use el menú desplegable Exportar Datos en cualquier informe de tráfico para exportar rápidamente datos por enlace, o agregue pivot=link_id a su solicitud de API.

Agregue pivot=link_id a su solicitud para obtener datos con:

• Fechas como filas (una fila por día)
• Enlaces como columnas (una columna por enlace)

Ejemplo de salida pivote CSV/TSV

Ejemplo de salida pivote JSON

{
  "links": [
    {"id": 123, "name": "Mi Enlace", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Otro Enlace", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

El modo pivote es útil para:

• Comparar tráfico entre múltiples enlaces
• Importar en hojas de cálculo para análisis
• Construir paneles con todos los datos de enlaces en una llamada

Datos de clics sin procesar

Los datos de clics sin procesar que registramos, incluyendo parámetros completos, marcas de tiempo e información de geolocalización, están disponibles.

Para acceder a estos datos, haga clic en Exportar desde las pestañas en la parte inferior y elija su formato. Estas son solicitudes de API completamente formadas que puede usar directamente en su aplicación.

Notas sobre la exportación de datos

• Considere filtrar datos en la vista primero para reducir la cantidad de datos exportados. Esta función exporta los datos subyacentes utilizados para generar el informe actualmente en pantalla.
• Estos datos se almacenan en caché durante hasta 3 horas. Las solicitudes repetidas a este punto final no producirán datos en tiempo real.

Conteos agrupados

El punto final /counters/{dimension} devuelve totales de clics agrupados por una única dimensión, como country, platform, destination, referer, isp o link_id. Los resultados se devuelven ordenados por cantidad de clics, de mayor a menor.

Se devuelve un máximo de 10,000 valores. Las dimensiones de alta cardinalidad — destination, referer, remote_ip e isp — pueden tener muchos más valores distintos que eso en un espacio de trabajo activo. Cuando lo hacen, recibe los 10,000 principales por cantidad de clics y el resto no se devuelve.

El campo total es siempre el total de clics en todos los grupos, incluyendo los que no se devuelven. Así que en un resultado truncado los valores count sumarán menos que total — lo que significa que un porcentaje calculado como count / total sigue siendo preciso.

Si necesita el conjunto completo de valores en lugar de los 10,000 principales, exporte los datos de clics sin procesar y agréguelos usted mismo, o use la integración con BigQuery.

Notificaciones de clics en tiempo real

Para notificaciones de clics en tiempo real, vea Webhooks. Los webhooks envían una solicitud POST a sus URL especificadas inmediatamente cuando ocurre un clic, con información detallada sobre el clic.

También puede gestionar webhooks a través de la API - consulte la especificación OpenAPI para más detalles.

Política de uso justo

Límites de velocidad

La API de Análisis está limitada a 50 solicitudes por hora por espacio de trabajo.

Límites de uso

Además de los límites de velocidad, la API de Análisis tiene límites de uso que se reinician cada período de facturación:

Qué cuenta como uso

• Solicitudes de API: Cada llamada a los puntos finales de la API de Análisis (/clicks, /counters, /export) cuenta como una solicitud.
• Datos Escaneados: La cantidad de datos procesados por nuestra base de datos de análisis para cumplir su solicitud. Los rangos de fechas más grandes y las consultas más complejas escanean más datos.

Qué sucede cuando excede los límites

Si excede sus límites de uso:

1. 1
   Las solicitudes de API devolverán un error 429 Too Many Requests
2. 2
   Sus límites se reiniciarán automáticamente al comienzo de su próximo período de facturación
3. 3
   Sus enlaces continuarán funcionando y rastreando clics normalmente

Consejos para reducir el uso

La mayoría de los usuarios pueden obtener todos sus datos en una única solicitud de API usando el modo pivote (pivot=link_id), que devuelve el tráfico de todos los enlaces como una matriz en una sola llamada.

• Use modo pivote: Agregue pivot=link_id para obtener tráfico de todos los enlaces en una única solicitud en lugar de consultar cada enlace por separado
• Respuestas en caché: Almacene respuestas de API localmente en lugar de recuperar los mismos datos repetidamente
• Use rangos de fechas más pequeños: Consulte solo las fechas que necesita
• Solicitudes por lotes: Combine múltiples consultas de enlaces en una única solicitud usando el parámetro link_ids

¿Necesita más?

Si necesita límites más altos, por favor hable con nosotros usando el widget de soporte.

Integración con BigQuery

Para necesidades de análisis de alto volumen, Linkly ofrece una integración con BigQuery que proporciona acceso directo a SQL a sus datos de clics.

• Acceso a datos en vivo - Consulte sus datos de clics directamente en BigQuery con actualizaciones en tiempo real
• Consultas ilimitadas - Sin límites de velocidad de API; solo paga por el cálculo de BigQuery
• Informes personalizados - Construya paneles con Looker, Data Studio o Tableau
• Consolidación de datos - Combine datos de clics con otras métricas comerciales

La integración con BigQuery está incluida en el plan Enterprise. Contáctenos para más detalles.

Obtenga más información sobre la Integración con BigQuery →

Relacionado

• API de Acortamiento de Enlaces - Crear y actualizar enlaces mediante programación
• Webhooks - Notificaciones de clics en tiempo real
• Integración con BigQuery - Acceso directo a SQL a datos de clics
• Integración con Zapier - Integraciones sin código