API de Análisis de Linkly

Exporta datos de clics e informes de tráfico desde Linkly de forma programática 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 copies y pegues en tus aplicaciones.

Ahorra tiempo y déjanos hacer el trabajo difícil. Nuestra API es completamente consumible por máquinas.

Cómo Comenzar con la API de Análisis

1

Abre cualquier informe de tráfico en Linkly.

2

Copia la solicitud de API que se muestra en la parte superior del informe.

Puedes elegir CSV o JSON. Este enlace contiene tu clave de API.

Estos enlaces están junto a cada tabla y gráfico en Linkly.

Copia la solicitud de API que se muestra en la parte superior del informe.
Copia la solicitud de API que se muestra en la parte superior del informe.
3

Pide a ChatGPT o un equivalente que adapte estas solicitudes en código fuente para tu aplicación.

No es necesario dedicar tiempo a hacer una integración compleja.

Autorización

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

Cómo Encontrar tus Credenciales de API

1

Inicia sesión en Linkly.

2

Haz clic en Configuración.

3

Haz clic en Claves de API.

API de Informes de Tráfico

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

Linkly's Traffic Reports API
Linkly's Traffic Reports API

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

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

Formatos de Salida

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

FormatoParámetroDescripción
JSONformat=json (predeterminado)Datos estructurados para aplicaciones
CSVformat=csvValores separados por comas para hojas de cálculo
TSVformat=tsvValores separados por tabulaciones, ideal para visualización en navegador y pegado en hojas de cálculo

Modo Pivote (Formato Matriz)

Por defecto, la API devuelve datos de series temporales con una fila por fecha. Con el 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 añade pivot=link_id a tu solicitud de API.

Export Data dropdown
Export Data dropdown

Añade 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

Mi EnlaceOtro Enlace
nameMi EnlaceOtro Enlace
full_urlhttps://linkly.link/abchttps://linkly.link/xyz
id123456
2025-12-304512
2025-12-31528
2026-01-013815

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 sola 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, 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.

Export Raw Data
Export Raw Data
Raw Click Data Example
Raw Click Data Example

Notas Sobre la Exportación de Datos

  • Considera filtrar los 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é hasta por 3 horas. Las solicitudes repetidas a este endpoint 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(es) especificada(s) inmediatamente cuando ocurre un clic, con información detallada sobre el clic.

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

Política de Uso Justo

Límites de Tasa

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

Tipo de PlanSolicitudes de APIDatos Escaneados
Gratuito100/mes10 GB/mes
Pago Mensual2,000/mes2 TB/mes
Pago Anual24,000/año24 TB/año
Ilimitado Mensual10,000/mes2 TB/mes
Ilimitado Anual120,000/año24 TB/año

Qué Cuenta como Uso

  • Solicitudes de API: Cada llamada a los endpoints 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 tu solicitud. Rangos de fechas más grandes y consultas más complejas escanean más datos.

Qué Sucede Cuando Excedes los Límites

Si excedes tus límites de uso:

  1. 1Las solicitudes de API devolverán un error 429 Too Many Requests
  2. 2Tus límites se restablecerán automáticamente al inicio de tu próximo período de facturación
  3. 3Tus 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.

  • Usa el modo pivote: Añade pivot=link_id para obtener el 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 necesites
  • 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 habla 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 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 tasa de API; solo pagas por el cómputo de BigQuery
  • Informes personalizados - Construye paneles con Looker, Data Studio o Tableau
  • Consolidación de datos - Une datos de clics con otras métricas de negocio

La integración con BigQuery es gratuita para clientes del plan Ilimitado, o está disponible como complemento de $100/mes para otros planes.

Aprende más sobre la Integración con BigQuery →

Relacionado

Track 1000 monthly clicks with all features included.

No credit card required