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

Antes de Começar

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

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

Autorização

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

API de Relatórios de Tráfego

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 seus próprios aplicativos.

Formatos de Saída

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

Modo Pivot (Formato de 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 entre vários links
• Importar em planilhas para análise
• Construir dashboards com todos os dados de links em uma única 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 nas abas na parte inferior e escolha seu formato. Estas são solicitações de API totalmente formadas que você pode usar diretamente em seu aplicativo.

Notas Sobre Exportação de Dados

• 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 esse endpoint não produzirão dados em tempo real.

Notificações de Cliques em Tempo Real

Para notificações de cliques em tempo real, consulte Webhooks. Os 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 - consulte a especificação OpenAPI para detalhes.

Política de Uso Justo

Limites de Taxa

A API de Analytics é limitada a 50 solicitações por hora por workspace.

Limites de Uso

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

O que Conta como Uso

• Solicitações de API: Cada chamada aos endpoints da API de Analytics (/clicks, /counters, /export) conta como uma solicitação.
• Dados Verificados: A quantidade de dados processados pelo nosso banco de dados de analytics 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 redefinidos automaticamente no início do seu próximo período de faturamento
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 única chamada.

• Use o modo pivot: 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 de 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

Precisa de Mais?

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

Integração BigQuery

Para necessidades de análise em alto volume, o Linkly oferece uma integração BigQuery que fornece acesso direto via SQL 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 de API; você apenas paga pelo cálculo do BigQuery
• Relatórios personalizados - Crie dashboards com Looker, Data Studio ou Tableau
• Consolidação de dados - Combine dados de cliques com outras métricas de negócios

A integração BigQuery está incluída no plano Enterprise. Entre em contato conosco para detalhes.

Saiba mais sobre a Integração BigQuery →

Relacionado

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