API de Análisis de Linkly

Exporte datos de clics e informes de tráfico desde Linkly programáticamente usando nuestra API de Análisis.

Relacionado: API de Acortamiento de Enlaces | Webhooks

Antes de Comenzar

Linkly genera solicitudes 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 API mostrada en la parte superior del informe.

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

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

Copia la solicitud API mostrada en la parte superior del informe.
Copia la solicitud API mostrada en la parte superior del informe.
3

Pídele a ChatGPT o un equivalente que adapte estas solicitudes al código fuente de tu aplicación.

No hay necesidad de perder tiempo haciendo una integración compleja.

Autorización

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

Cómo Encontrar tus Credenciales API

1

Inicia sesión en Linkly.

2

Haz clic en Configuración.

3

Haz clic en Claves API.

API de Informes de Tráfico

Linkly produce automáticamente solicitudes 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 API para ti, basadas en los datos mostrados en la pantalla.

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

Formatos de Salida

La API de Análisis soporta 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 sola 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 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 a través de múltiples enlaces
  • Importar a 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 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 usados para generar el informe actualmente en la pantalla.
  • Estos datos están en caché durante hasta 3 horas. 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(s) 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 reinician cada período de facturación:

Tipo de PlanSolicitudes 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 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 API devolverán un error 429 Too Many Requests
  2. 2Tus límites se reiniciará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 sola solicitud 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 tráfico de todos los enlaces en una sola solicitud en lugar de consultar cada enlace por separado
  • Almacena en caché las respuestas: Guarda las respuestas 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 sola 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 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 disponible como un complemento de $100/mes para otros planes.

Más información sobre la Integración con BigQuery →

Relacionado

Rastrea 500 clics mensuales con todas las características incluidas.

No se requiere tarjeta de crédito