Link shortener

Link statistics

Retrieve daily clicks and the total for a link over a period of up to 366 days.

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

Returns a link's daily click counts and the total for the requested period. Identify the link with the id query parameter.

Set the date range

Send inicio and fim in YYYY-MM-DD format. Both dates are included, and the range can span up to 366 days.

No dates: the last 30 days, including today.
Only fim: the 30 days ending on that date.
Only inicio: from that date through today.

Invalid dates, a start date after the end date, or ranges longer than 366 days return HTTP 400.

Read the results

Field	Description
`link`	Details of the requested link, including `criado_por`.
`periodo`	The start and end dates used by the query.
`total_cliques`	Total clicks recorded during the period.
`cliques_por_dia`	An array containing `data` and `cliques` for every day in the range, including days with zero clicks.

Access and metric updates

Queries follow the token's scope: personal links on Pro and company links on Business. A link that does not exist or is outside this scope returns 404.

Today's click count continues to increase throughout the day. For recurring reports, you can store previous results and query the current day again to refresh the report.

Parameters

Header

Authorizationstringrequired: Send Bearer followed by your API token, for example Authorization: Bearer YOUR_TOKEN.

Query parameters

idintegerrequired: Link ID returned when creating or listing links.
iniciostring: First date of the range, in YYYY-MM-DD format. If omitted, the range starts 29 days before fim.
fimstring: Last date of the range, in YYYY-MM-DD format. Default: today. This date is included.

Request example

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'])

Responses

Link details, requested date range, daily clicks, and the period total.

{
  "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 }
    ]
  }
}

Missing or invalid ID, unknown parameter, invalid date, or date range outside the limits.

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

Link not found or outside the token's access scope.

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

Daily quota or per-minute limit reached. Wait for the duration in Retry-After.

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