API de Análise da Linkly

Exporte dados de cliques e relatórios de tráfego da Linkly programaticamente 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 seus aplicativos.

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

Autorização

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

API de Relatórios de Tráfego

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

Os relatórios de tráfego da 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 Análise suporta três formatos de saída:

Modo de pivô (formato de matriz)

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

Exemplo de saída de pivô CSV/TSV

Exemplo de saída de pivô JSON

{
  "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 de pivô é útil para:

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

Dados brutos de cliques

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 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 este 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 suas URLs especificadas 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 Análise é limitada a 50 solicitações por hora por workspace.

Limites de uso

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:

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 Verificados: A quantidade de dados processados pelo 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ê ultrapassa os limites

Se você ultrapassar 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 uso

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

• Use o modo de 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 de API localmente em vez de buscar os mesmos dados repetidamente
• Use intervalos de datas menores: Consulte apenas as datas necessárias
• 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 superiores, fale conosco usando o widget de suporte.

Integração BigQuery

Para necessidades de análise de alto volume, a Linkly oferece uma integração BigQuery que oferece 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 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 - 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 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 SQL direto aos dados de cliques
• Integração Zapier - Integrações sem código