API de Analytics do Linkly

Exporte dados de cliques e relatórios de tráfego do Linkly programaticamente usando nossa API de Analytics.

Relacionado: API de Encurtamento de Links | Webhooks

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

Economize tempo e deixe-nos fazer o trabalho pesado. Nossa API é totalmente consumível por máquinas.

Você precisará da sua Chave de API e ID do Workspace. Você pode obter estes detalhes dentro do Linkly.

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

Os relatórios de tráfego do Linkly criam automaticamente requisições de API para você, baseadas nos dados mostrados na tela.

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

A API de Analytics suporta três formatos de saída:

Por padrão, a API retorna dados de séries temporais com uma linha por data. Com o modo pivot, você pode obter o tráfego de todos os seus links em uma única requisiçã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 requisição de API.

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

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

{
  "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 entre múltiplos links
• Importar para planilhas para análise
• Criar dashboards com todos os dados de links em uma única chamada

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

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

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

Para notificações de cliques em tempo real, veja Webhooks. Webhooks enviam uma requisição POST para sua(s) URL(s) especificada(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.

A API de Analytics tem limite de taxa de 50 requisições por hora por workspace.

Além dos limites de taxa, a API de Analytics tem limites de uso que são redefinidos a cada período de cobrança:

• Requisições de API: Cada chamada aos endpoints da API de Analytics (/clicks, /counters, /export) conta como uma requisição.
• Dados Escaneados: A quantidade de dados processados pelo nosso banco de dados de analytics para atender sua requisição. Intervalos de datas maiores e consultas mais complexas escaneiam mais dados.

Se você exceder seus limites de uso:

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

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

• Use o modo pivot: Adicione pivot=link_id para obter tráfego de todos os links em uma única requisição em vez de consultar cada link separadamente
• Armazene respostas em cache: 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
• Agrupe requisições: Combine múltiplas consultas de links em uma única requisição usando o parâmetro link_ids

Se você precisar de limites maiores, por favor fale conosco usando o widget de suporte.

Para necessidades de analytics de alto volume, o Linkly oferece uma integração com BigQuery que fornece acesso SQL direto aos seus dados de cliques.

• Acesso a dados ao vivo - Consulte seus dados de cliques diretamente no BigQuery com atualizações em tempo real
• Consultas ilimitadas - Sem limites de taxa de API; você paga apenas pela computação do BigQuery
• Relatórios personalizados - Crie dashboards com Looker, Data Studio ou Tableau
• Consolidação de dados - Una dados de cliques com outras métricas de negócio

A integração com BigQuery é gratuita para clientes do plano Unlimited, ou disponível como um complemento de $100/mês para outros planos.

Saiba mais sobre Integração com BigQuery →

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