Encurtador de links

Estatísticas de um link

Consulte os cliques diários e o total de um link em um período de até 366 dias.

GEThttps://pqno.app/admin/api/encurtar-link/estatisticaslink

Retorna os cliques de um link por dia e o total do período solicitado. Identifique o link pelo parâmetro id.

Defina o período

Envie inicio e fim no formato AAAA-MM-DD. O período inclui as duas datas e aceita até 366 dias.

Sem datas: os últimos 30 dias, incluindo hoje.
Apenas fim: os 30 dias que terminam nessa data.
Apenas inicio: dessa data até hoje.

Datas inválidas, início posterior ao fim e períodos maiores que 366 dias retornam HTTP 400.

Interprete os resultados

Campo	Descrição
`link`	Dados do link consultado, incluindo `criado_por`.
`periodo`	Datas de início e fim efetivamente usadas na consulta.
`total_cliques`	Soma dos cliques registrados no período.
`cliques_por_dia`	Lista com `data` e `cliques` para cada dia do período, inclusive os dias com zero cliques.

Acesso e atualização dos números

A consulta respeita o escopo do token: links pessoais no Pro e links da empresa no Business. Um link inexistente ou fora desse escopo retorna 404.

Os cliques de hoje continuam aumentando ao longo do dia. Em consultas recorrentes, você pode armazenar os resultados anteriores e consultar novamente o dia atual para atualizar o relatório.

Parâmetros

Cabeçalho

Authorizationtextoobrigatório: Envie Bearer seguido do token da API, como Authorization: Bearer SEU_TOKEN.

Parâmetros de consulta

idinteiroobrigatório: ID do link retornado na criação ou na listagem.
iniciotexto: Primeira data do período, em AAAA-MM-DD. Se omitida, o período começa 29 dias antes de fim.
fimtexto: Última data do período, em AAAA-MM-DD. Padrão: hoje. A data é incluída na consulta.

Exemplo de requisição

curl -sS "https://pqno.app/admin/api/encurtar-link/estatisticaslink?id=4821&inicio=2026-09-27&fim=2026-10-03" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const query = new URLSearchParams({ id: '4821', inicio: '2026-09-01', fim: '2026-09-30' });
const resposta = await fetch(`https://pqno.app/admin/api/encurtar-link/estatisticaslink?${query}`, {
  headers: { 'Authorization': `Bearer ${process.env.PQNO_TOKEN}` }
});
const json = await resposta.json();
if (json.status !== 'ok') throw new Error(json.mensagem);
console.log(json.dados.total_cliques);
for (const dia of json.dados.cliques_por_dia) console.log(dia.data, dia.cliques);

<?php
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/estatisticaslink?id=4821');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('PQNO_TOKEN')],
]);
$json = json_decode(curl_exec($ch), true);
if (($json['status'] ?? '') !== 'ok') {
    throw new RuntimeException($json['mensagem'] ?? '');
}
echo 'Últimos 30 dias: ', $json['dados']['total_cliques'], PHP_EOL;

import os
import requests

resposta = requests.get(
    'https://pqno.app/admin/api/encurtar-link/estatisticaslink',
    headers={'Authorization': f"Bearer {os.environ['PQNO_TOKEN']}"},
    params={'id': 4821, 'inicio': '2026-09-01', 'fim': '2026-09-30'},
    timeout=30,
)
corpo = resposta.json()
if corpo['status'] != 'ok':
    raise RuntimeError(corpo['mensagem'])
for dia in corpo['dados']['cliques_por_dia']:
    print(dia['data'], dia['cliques'])

Respostas

Dados do link, período consultado e cliques por dia, com o total do período.

{
  "status": "ok",
  "dados": {
    "link": {
      "id": 4821,
      "codigo": "promo-outubro",
      "url_curta": "https://pqno.app/promo-outubro",
      "url": "https://exemplo.com.br/campanha?utm_source=email",
      "titulo": "Campanha de outubro",
      "descricao": "",
      "criado_em": "2026-09-26T14:32:10-03:00",
      "criado_por": { "id": 37, "nome": "Marina Souza" },
      "expira_em": null,
      "max_cliques": null,
      "cliques_contados": 0,
      "com_senha": false,
      "etiquetas": [],
      "pixels": {}
    },
    "periodo": {
      "inicio": "2026-09-27",
      "fim": "2026-10-03"
    },
    "total_cliques": 412,
    "cliques_por_dia": [
      { "data": "2026-09-27", "cliques": 88 },
      { "data": "2026-09-28", "cliques": 75 },
      { "data": "2026-09-29", "cliques": 61 },
      { "data": "2026-09-30", "cliques": 0 },
      { "data": "2026-10-01", "cliques": 104 },
      { "data": "2026-10-02", "cliques": 53 },
      { "data": "2026-10-03", "cliques": 31 }
    ]
  }
}

ID inválido ou ausente, parâmetro desconhecido, data inválida ou período fora dos limites.

{
  "status": "erro",
  "mensagem": "O período vai até 366 dias."
}

Link inexistente ou fora do acesso do token.

{
  "status": "erro",
  "mensagem": "Link não encontrado."
}

Cota diária ou limite por minuto atingido. Aguarde o tempo informado em Retry-After.

{
  "status": "erro",
  "mensagem": "Cota diária de API atingida (1000/dia). Tente novamente amanhã."
}