API de Análise do Linkly

Exporte dados de cliques e relatórios de tráfego do Linkly de forma programática usando nossa API de Análise.

Relacionado: API de Encurtamento de Links | Webhooks

Antes de começar

Linkly gera solicitações de API na interface para você copiar e colar em suas aplicações.

Economize tempo e deixe que fazemos o trabalho pesado. Nossa API é totalmente consumível por máquina.

Autorização

Você precisará de sua Chave de API e ID do Espaço de Trabalho. Você pode obter esses detalhes dentro do Linkly.

API de relatórios de tráfego

Linkly automaticamente produz solicitações de API para você dentro de seus relatórios de tráfego.

Os relatórios de tráfego do Linkly constroem automaticamente solicitações de API para você, com base nos dados mostrados na tela.

Esses links incluem sua chave de API e são facilmente personalizáveis e utilizáveis em suas próprias aplicações.

Formatos de saída

A API de Análise suporta três formatos de saída:

Modo pivot (formato matriz)

Por padrão, a API retorna dados de série temporal com uma linha por data. Com o modo pivot, você pode obter o tráfego de todos os seus links em uma única solicitação como uma matriz.

Use o dropdown Exportar Dados em qualquer relatório de tráfego para exportar rapidamente dados por link, ou adicione pivot=link_id à sua solicitação de API.

Adicione pivot=link_id à sua solicitação para obter dados com:

• Datas como linhas (uma linha por dia)
• Links como colunas (uma coluna por link)

Exemplo de saída pivot CSV/TSV

Exemplo de saída pivot JSON

{
  "links": [
    {"id": 123, "name": "Meu Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Outro Link", "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}}
  ]
}

O modo pivot é útil para:

• Comparar tráfego em vários links
• Importar para planilhas para análise
• Construir painéis com todos os dados de link em uma chamada

Dados de cliques brutos

Os dados de cliques brutos que registramos, incluindo parâmetros completos, timestamps e informações de geolocalização, estão disponíveis.

Para acessar esses dados, clique em Exportar das abas na parte inferior e escolha seu formato. Essas são solicitações de API totalmente formadas que você pode usar diretamente em sua aplicação.

Notas sobre exportação de dados

• Considere filtrar dados na visualização primeiro para reduzir a quantidade de dados exportados. Essa função exporta os dados subjacentes usados para gerar o relatório atualmente na tela.
• Esses dados são armazenados em cache por até 3 horas. Solicitações repetidas para este endpoint não produzirão dados em tempo real.

Contagens agrupadas

O endpoint /counters/{dimension} retorna totais de cliques agrupados por uma única dimensão — como country, platform, destination, referer, isp ou link_id. Os resultados voltam ordenados por contagem de cliques, maior primeiro.

Um máximo de 10.000 valores são retornados. Dimensões de alta cardinalidade — destination, referer, remote_ip e isp — podem ter muito mais valores distintos do que isso em um espaço de trabalho ocupado. Quando fazem, você recebe os 10.000 principais por contagem de cliques e o resto não é retornado.

O campo total é sempre o total de cliques em cada grupo, incluindo qualquer um não retornado. Então em um resultado truncado os valores count serão somados a menos do que total — o que significa que um percentual calculado como count / total ainda é preciso.

Se você precisar do conjunto completo de valores em vez dos 10.000 principais, exporte os dados de clique bruto e agregue você mesmo, ou use a integração BigQuery.

Notificações de cliques em tempo real

Para notificações de cliques em tempo real, veja Webhooks. Webhooks enviam uma solicitação POST para seu(s) URL(s) especificado(s) imediatamente quando um clique ocorre, com informações detalhadas sobre o clique.

Você também pode gerenciar webhooks via API - veja a especificação OpenAPI para detalhes.

Política de uso justo

Limites de taxa

A API de Análise é limitada a 50 solicitações por hora por espaço de trabalho.

Limites de uso

Além dos limites de taxa, a API de Análise tem limites de uso que reiniciam a cada período de cobrança:

O que conta como uso

• Solicitações de API: Cada chamada para os endpoints da API de Análise (/clicks, /counters, /export) conta como uma solicitação.
• Dados Escaneados: A quantidade de dados processados por nosso banco de dados de análise para atender sua solicitação. Intervalos de datas maiores e consultas mais complexas verificam mais dados.

O que acontece quando você excede os limites

Se você exceder seus limites de uso:

1. 1
   As solicitações de API retornarão um erro 429 Too Many Requests
2. 2
   Seus limites serão automaticamente reiniciados no início do seu próximo período de cobrança
3. 3
   Seus links continuarão funcionando e rastreando cliques normalmente

Dicas para reduzir o uso

A maioria dos usuários pode obter todos os seus dados em uma única solicitação de API usando o modo pivot (pivot=link_id), que retorna o tráfego de todos os links como uma matriz em uma chamada.

• Use modo pivot: Adicione pivot=link_id para obter tráfego de todos os links em uma única solicitação em vez de consultar cada link separadamente
• Cache de respostas: Armazene respostas de API localmente em vez de buscar os mesmos dados repetidamente
• Use intervalos de datas menores: Consulte apenas as datas que você precisa
• Solicitações em lote: Combine várias consultas de link em uma única solicitação usando o parâmetro link_ids

Precisa de mais?

Se você precisar de limites mais altos, fale conosco usando o widget de suporte.

Integração BigQuery

Para necessidades de análise de alto volume, Linkly oferece uma integração BigQuery que fornece acesso SQL direto aos seus dados de clique.

• Acesso a dados ao vivo - Consulte seus dados de clique diretamente no BigQuery com atualizações em tempo real
• Consultas ilimitadas - Sem limites de taxa de API; você só paga pelo compute do BigQuery
• Relatórios personalizados - Construa painéis com Looker, Data Studio ou Tableau
• Consolidação de dados - Junte dados de clique com outras métricas de negócio

A integração BigQuery está incluída no plano Enterprise. Contacte-nos para detalhes.

Saiba mais sobre Integração BigQuery →

Relacionado

• API de Encurtamento de Links - Crie e atualize links de forma programática
• Webhooks - Notificações de cliques em tempo real
• Integração BigQuery - Acesso SQL direto aos dados de clique
• Integração Zapier - Integrações sem código