Link shortener

Account summary

Retrieve link counts, clicks, unavailable destinations, and API usage in one request.

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

Returns metrics for links accessible to the token, along with API usage. A company token also includes metrics for each person.

Click date range

inicio and fim follow the rules in Link statistics: YYYY-MM-DD dates, a range of up to 366 days, and the last 30 days when omitted.

The range applies to cliques.no_periodo and pessoas[].cliques_no_periodo. cliques.hoje always refers to today, while link counts reflect the account's current state.

Summary fields

Field	Description
`escopo`	`pessoal` for personal tokens or `empresa` for company tokens.
`plano`	Plan applied to the token: `pro` or `business`.
`periodo`	Start and end dates used for click metrics.
`links.total`	Current number of links within the token's scope.
`links.limite`	The plan's link limit, or `null` for unlimited links.
`links.fora_do_ar`	Number of links with destinations recorded as unavailable.
`cliques.no_periodo / cliques.hoje`	Clicks during the requested period and today.
`api`	Daily usage and per-minute limit: `cota_diaria`, `usadas_hoje`, `restantes_hoje`, and `limite_por_minuto`.

This request counts toward the daily quota. api.usadas_hoje already includes the summary request.

Per-person metrics on Business

The pessoas field is included for company tokens and sorted by clicks during the period, highest first. Each item contains:

Field	Description
`id / nome`	Person's identity. Use `id` as the `usuario` filter in List links.
`ativo`	Whether the person still has access to the company.
`links`	Number of links the person created within the company.
`cliques_no_periodo`	Clicks on those links during the requested period.

People who have lost access may still appear when they have links within the company. Their records use ativo: false.

Parameters

Header

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

Query parameters

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/resumo?inicio=2026-09-01&fim=2026-09-30" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const resposta = await fetch('https://pqno.app/admin/api/encurtar-link/resumo', {
  headers: { 'Authorization': `Bearer ${process.env.PQNO_TOKEN}` }
});
const json = await resposta.json();
if (json.status !== 'ok') throw new Error(json.mensagem);
console.log('Chamadas que ainda cabem hoje:', json.dados.api.restantes_hoje);
for (const pessoa of json.dados.pessoas ?? []) {
  console.log(pessoa.nome, pessoa.links, pessoa.cliques_no_periodo);
}

<?php
$query = http_build_query(['inicio' => '2026-09-01', 'fim' => '2026-09-30']);
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/resumo?' . $query);
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 $json['dados']['links']['total'], ' links, ', $json['dados']['cliques']['no_periodo'], ' cliques', PHP_EOL;
foreach ($json['dados']['pessoas'] ?? [] as $pessoa) {
    echo $pessoa['nome'], ': ', $pessoa['cliques_no_periodo'], PHP_EOL;
}

import os
import requests

resposta = requests.get(
    'https://pqno.app/admin/api/encurtar-link/resumo',
    headers={'Authorization': f"Bearer {os.environ['PQNO_TOKEN']}"},
    timeout=30,
)
corpo = resposta.json()
if corpo['status'] != 'ok':
    raise RuntimeError(corpo['mensagem'])
print('Restam hoje:', corpo['dados']['api']['restantes_hoje'])
for pessoa in corpo['dados'].get('pessoas', []):
    print(pessoa['nome'], pessoa['links'], pessoa['cliques_no_periodo'])

Responses

Account metrics and API usage. Company tokens also include the pessoas list.

{
  "status": "ok",
  "dados": {
    "escopo": "empresa",
    "plano": "business",
    "periodo": {
      "inicio": "2026-09-04",
      "fim": "2026-10-03"
    },
    "links": {
      "total": 214,
      "limite": null,
      "fora_do_ar": 2
    },
    "cliques": {
      "no_periodo": 18230,
      "hoje": 412
    },
    "api": {
      "cota_diaria": 10000,
      "usadas_hoje": 1286,
      "restantes_hoje": 8714,
      "limite_por_minuto": 60
    },
    "pessoas": [
      {
        "id": 37,
        "nome": "Marina Souza",
        "ativo": true,
        "links": 96,
        "cliques_no_periodo": 11540
      },
      {
        "id": 52,
        "nome": "Rafael Lima",
        "ativo": true,
        "links": 81,
        "cliques_no_periodo": 5902
      },
      {
        "id": 18,
        "nome": "Paula Mendes",
        "ativo": false,
        "links": 37,
        "cliques_no_periodo": 788
      }
    ]
  }
}

Unknown parameter, invalid date, or date range outside the limits.

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

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ã."
}