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-nos fazer 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 produz 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ê, 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.

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 o modo pivô, você pode obter o tráfego de todos os seus links em uma única solicitação como uma matriz.

Use o menu suspenso 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)

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other 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 pivô é útil para:

• Comparar tráfego entre múltiplos links
• Importar para planilhas para análise
• Construir painéis com dados de todos os links em uma única chamada

Os dados brutos de cliques que registramos, incluindo parâmetros completos, carimbos de data/hora 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, consulte Webhooks. Os webhooks enviam uma solicitaçã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 - consulte a especificação OpenAPI para detalhes.

A API de Análise tem limite de taxa de 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 cobrança:

• Solicitações de API: Cada chamada aos 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 escaneiam mais dados.

Se você exceder seus limites de uso:

1. 1As solicitaçõ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 a funcionar e rastrear cliques normalmente

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

• Use o modo pivô: Adicione pivot=link_id para obter tráfego de 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 maiores, por favor fale conosco usando o widget de suporte.

Para necessidades de análise 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 - Construa painéis com Looker, Data Studio ou Tableau
• Consolidação de dados - Junte dados de cliques com outras métricas de negócios

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

Saiba mais sobre a 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