API de Analítica de Linkly

Exporta datos de clics e informes de tráfico desde Linkly mediante programación utilizando nuestra API de Analítica.

Relacionado: API de Acortamiento de Enlaces | Webhooks

Antes de comenzar

Linkly genera solicitudes de API en la interfaz para que las copies y pegues en tus aplicaciones.

Ahorra tiempo y deja que hagamos el trabajo duro. Nuestra API es completamente consumible por máquinas.

Autorización

Necesitarás tu Clave de API e ID de Espacio de Trabajo. Puedes obtener estos detalles desde dentro de Linkly.

API de Informes de Tráfico

Linkly genera automáticamente solicitudes de API para ti dentro de tus informes de tráfico.

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

Estos enlaces incluyen tu clave de API y son fáciles de personalizar y utilizar en tus propias aplicaciones.

Formatos de salida

La API de Analítica admite tres formatos de salida:

Modo pivote (formato de matriz)

De forma predeterminada, la API devuelve datos de series de tiempo con una fila por fecha. Con modo pivote, puedes obtener el tráfico de todos tus enlaces en una única solicitud como una matriz.

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

Agrega pivot=link_id a tu 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 dashboards con todos los datos de enlaces en una sola llamada

Datos de clics sin procesar

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

Para acceder a estos datos, haz clic en Exportar en las pestañas de la parte inferior y elige tu formato. Estas son solicitudes de API completamente formadas que puedes usar directamente en tu aplicación.

Notas sobre la exportación de datos

• Considera 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 la pantalla.
• Estos datos se almacenan en caché durante un máximo de 3 horas. Las solicitudes repetidas a este punto final no producirán datos en tiempo real.

Notificaciones de clics en tiempo real

Para notificaciones de clics en tiempo real, consulta Webhooks. Los webhooks envían una solicitud POST a tu(s) URL especificada(s) inmediatamente cuando ocurre un clic, con información detallada sobre el clic.

También puedes administrar webhooks a través de la API: consulta la especificación OpenAPI para obtener más detalles.

Política de uso justo

Límites de velocidad

La API de Analítica tiene un límite de velocidad de 50 solicitudes por hora por espacio de trabajo.

Límites de uso

Además de los límites de velocidad, la API de Analítica 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 Analítica (/clicks, /counters, /export) cuenta como una solicitud.
• Datos Escaneados: La cantidad de datos procesados por nuestra base de datos de analítica para cumplir con tu solicitud. Los rangos de fechas más grandes y las consultas más complejas escanean más datos.

Qué sucede cuando superas los límites

Si superas tus límites de uso:

1. 1
   Las solicitudes de API devolverán un error 429 Too Many Requests
2. 2
   Tus límites se restablecerán automáticamente al inicio de tu próximo período de facturación
3. 3
   Tus 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 modo pivote (pivot=link_id), que devuelve el tráfico de todos los enlaces como una matriz en una sola llamada.

• Usa modo pivote: Agrega pivot=link_id para obtener tráfico de todos los enlaces en una única solicitud en lugar de consultar cada enlace por separado
• Almacena respuestas en caché: Guarda las respuestas de la API localmente en lugar de obtener los mismos datos repetidamente
• Usa rangos de fechas más pequeños: Consulta solo las fechas que necesitas
• Agrupa solicitudes: Combina múltiples consultas de enlaces en una única solicitud usando el parámetro link_ids

¿Necesitas más?

Si necesitas límites más altos, por favor comunícate con nosotros usando el widget de soporte.

Integración de BigQuery

Para necesidades de analítica de alto volumen, Linkly ofrece una integración de BigQuery que proporciona acceso directo SQL a tus datos de clics.

• Acceso a datos en vivo - Consulta tus datos de clics directamente en BigQuery con actualizaciones en tiempo real
• Consultas ilimitadas - Sin límites de velocidad de API; solo pagas por computación de BigQuery
• Reportes personalizados - Construye dashboards con Looker, Data Studio o Tableau
• Consolidación de datos - Combina datos de clics con otras métricas comerciales

La integración de BigQuery está incluida en el plan Enterprise. Contáctanos para obtener más detalles.

Obtén más información sobre la Integración de BigQuery →

Relacionado

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