API de Análise do Linkly

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

Relacionado: API de Encurtamento de Links | Webhooks

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

Economize tempo e deixe que façamos o trabalho pesado. Nossa API é totalmente consumível por máquinas.

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

O Linkly gera automaticamente 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ê, baseado nos dados mostrados na tela.

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

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

Por padrão, a API retorna dados de série temporal com uma linha por data. Com modo dinâmico, 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 dados rapidamente 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)

{
  "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 dinâmico é útil para:

• Comparar tráfego entre vários links
• Importar em planilhas para análise
• Construir dashboards com dados de todos os 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 esses dados, clique em Exportar nas 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.

• 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.
• 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.

Para notificações de cliques em tempo real, veja Webhooks. Webhooks enviam uma solicitação POST para seus URLs especificados 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 Análise é limitada a 50 solicitações por hora por workspace.

Além dos limites de taxa, a API de Análise tem limites de uso que são redefinidos a cada período de faturamento:

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

Se você exceder seus limites de uso:

1. 1Solicitaçõ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 faturamento
3. 3Seus links continuarão funcionando e rastreando cliques normalmente

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

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

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

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

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

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

Saiba mais sobre Integração BigQuery →

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