API de Análisis de Linkly

Exporta datos de clics e informes de tráfico de Linkly mediante programación usando nuestro 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 copies y pegues en tus aplicaciones.

Ahorra tiempo y deja que hagamos el trabajo difícil. Nuestro API es completamente legible 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 construyen automáticamente solicitudes de API para ti, basadas en los datos que se muestran en la pantalla.

Estos enlaces incluyen tu clave de API y son fácilmente personalizables y utilizables en tus propias aplicaciones.

Formatos de salida

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

Modo pivote (formato de matriz)

De forma predeterminada, el API devuelve datos de series temporales 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 la lista 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 a hojas de cálculo para análisis
• Construir paneles con todos los datos de enlace en una llamada

Datos de clics brutos

Los datos de clics brutos 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 desde las pestañas en la parte inferior y elige tu formato. Estas son solicitudes de API completamente formadas que puedes usar directamente en tu aplicación.

Notas respecto a 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 hasta 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 URL especificada inmediatamente cuando ocurre un clic, con información detallada sobre el clic.

También puedes administrar webhooks a través del API - consulta la especificación OpenAPI para detalles.

Política de uso justo

Límites de velocidad

El API de Análisis 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, el API de Análisis tiene límites de uso que se restablecen cada período de facturación:

Qué cuenta como uso

• Solicitudes de API: Cada llamada a los puntos finales del 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 tu solicitud. Los rangos de fechas más grandes y las consultas más complejas escanean más datos.

Qué sucede cuando excedes los límites

Si excedes 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 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 llamada.

• Usa modo pivote: Agrega pivot=link_id para obtener tráfico para todos los enlaces en una única solicitud en lugar de consultar cada enlace por separado
• Almacena respuestas en caché: Guarda las respuestas de API localmente en lugar de obtener los mismos datos repetidamente
• Usa rangos de fechas más pequeños: Consulta solo las fechas que necesitas
• Solicitudes por lotes: 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 habla con nosotros usando el widget de soporte.

Integración de BigQuery

Para necesidades de análisis de alto volumen, Linkly ofrece una integración de BigQuery que proporciona acceso SQL directo 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 el cálculo de BigQuery
• Reportes personalizados - Construye paneles con Looker, Data Studio o Tableau
• Consolidación de datos - Combina datos de clics con otras métricas comerciales

La integración de BigQuery se incluye en el plan Enterprise. Contáctanos para 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 SQL directo a datos de clics
• Integración de Zapier - Integraciones sin código