API de Análisis de Linkly

Exporte datos de clics e informes de tráfico desde 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 pesado. Nuestra API es completamente consumible por máquinas.

Autorización

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

API de Informes de Tráfico

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

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

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

Formatos de salida

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

Modo pivote (formato de matriz)

De forma predeterminada, la API devuelve datos de series temporales con una fila por fecha. Con 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 varios enlaces
• Importar en hojas de cálculo para análisis
• Crear paneles con todos los datos de enlaces en una llamada

Datos de clics sin procesar

Los datos de clics sin procesar que registramos, incluida información de 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 que se muestra actualmente en la pantalla.
• Estos datos se almacenan en caché 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 sola dimensión, como country, platform, destination, referer, isp o link_id. Los resultados vienen ordenados por conteo de clics, mayor primero.

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 ese en un espacio de trabajo ocupado. Cuando lo hacen, recibe los 10,000 principales por conteo de clics y el resto no se devuelven.

El campo total siempre es el total de clics en todos los grupos, incluidos los no devueltos. Entonces, 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 de BigQuery.

Notificaciones de clics en tiempo real

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

También puede administrar webhooks a través de la API: consulte la especificación OpenAPI para obtener 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 restablecen en 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. Las exportaciones de enlaces (/links/export) realizadas con una clave de API también cuentan 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 fecha más grandes y las consultas más complejas escanean más datos.

Qué sucede cuando excede los límites

Cuando un espacio de trabajo en un plan pago utiliza todas sus solicitudes de API, agregamos automáticamente un paquete de API a su suscripción para que sus integraciones sigan funcionando, y enviamos un correo electrónico a los miembros del espacio de trabajo para informarles. Un paquete de API agrega solicitudes de API adicionales en cada período de facturación hasta que lo elimine.

Las solicitudes de API devuelven un error 429 Too Many Requests en su lugar cuando:

1. 1
   El espacio de trabajo está en el plan Gratuito o Iniciador, que no puede agregar paquetes de API
2. 2
   La suscripción del espacio de trabajo está configurada para cancelarse, o hay un pago vencido
3. 3
   El espacio de trabajo ha utilizado toda su asignación de datos escaneados — los paquetes de API agregan solicitudes, no datos

Los límites de uso se restablecen al principio de cada período de facturación, y sus enlaces siguen funcionando y rastreando clics normalmente de cualquier manera.

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 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
• Almacene respuestas en caché: Almacene las respuestas de la API localmente en lugar de obtener los mismos datos repetidamente
• Use rangos de fecha 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?

Puede agregar paquetes de API usted mismo en cualquier momento en Add-ons en la página Facturación. Cada paquete agrega solicitudes de API adicionales en cada período de facturación; la página muestra el precio de su plan antes de que confirme.

Los paquetes de API no cambian el límite de velocidad. Si necesita un límite de velocidad más alto, por favor hable con nosotros usando el widget de soporte.

Integración de BigQuery

Para necesidades analíticas de alto volumen, Linkly ofrece una integración de BigQuery que proporciona acceso SQL directo 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 la computación de BigQuery
• Informes personalizados - Cree paneles con Looker, Data Studio o Tableau
• Consolidación de datos - Combine datos de clics con otras métricas comerciales

La integración de BigQuery se incluye en el plan Enterprise. Contáctenos para obtener más detalles.

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

Relacionado

• API de Acortamiento de Enlaces - Cree y actualice 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