Link shortener

Get a link

Retrieve a link by ID or code, including click counts and destination availability.

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

Retrieves a link's details, its current-month and lifetime click counts, and the recorded availability of its destination.

Identify the link

Send either id or codigo as a query parameter. Use only one:

id: the identifier returned when creating or listing links.
codigo: the portion after the slash in the short URL. For https://pqno.app/promo-outubro, the code is promo-outubro.

Providing both parameters or neither returns HTTP 400. A personal token can retrieve the issuer's links; a company token can retrieve links created by anyone in that company. A link outside this scope returns 404.

Response fields

In addition to the fields described in Create a link, dados includes:

Field	Description
`cliques_no_mes`	Clicks recorded during the current month.
`total_cliques`	Total clicks recorded since creation.
`destino_fora_do_ar`	Whether the latest check classified the destination as unavailable.
`fora_do_ar_desde`	The recorded start of the outage, or `null` when no outage is recorded.

Destination availability

pqno.app checks destinations periodically and after visits to short links. These fields report the recorded check results; this request does not perform a live availability check.

Changing the destination with Update a link schedules a new check. Retrieve the link again after the check runs to monitor the new destination.

Parameters

Header

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

Query parameters

idinteger: Link ID. Send either id or codigo, never both.
codigostring: Short URL code, without the domain or slash. Send either codigo or id, never both.

Request example

curl -sS "https://pqno.app/admin/api/encurtar-link/obterlink?codigo=promo-outubro" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const resposta = await fetch('https://pqno.app/admin/api/encurtar-link/obterlink?id=4821', {
  headers: { 'Authorization': `Bearer ${process.env.PQNO_TOKEN}` }
});
const json = await resposta.json();
if (json.status !== 'ok') throw new Error(json.mensagem);
if (json.dados.destino_fora_do_ar) console.log('Destino fora do ar desde', json.dados.fora_do_ar_desde);
console.log(json.dados.url, json.dados.total_cliques);

<?php
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/obterlink?' . http_build_query(['codigo' => 'promo-outubro']));
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']['url'], ' ', $json['dados']['total_cliques'], PHP_EOL;

import os
import requests

resposta = requests.get(
    'https://pqno.app/admin/api/encurtar-link/obterlink',
    headers={'Authorization': f"Bearer {os.environ['PQNO_TOKEN']}"},
    params={'id': 4821},
    timeout=30,
)
corpo = resposta.json()
if corpo['status'] != 'ok':
    raise RuntimeError(corpo['mensagem'])
print(corpo['dados']['url'], corpo['dados']['total_cliques'])

Responses

Link details, click counts, and recorded destination availability.

{
  "status": "ok",
  "dados": {
    "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-10-03T14:32:10-03:00",
    "criado_por": { "id": 37, "nome": "Marina Souza" },
    "expira_em": "2026-12-31T23:59:00-03:00",
    "max_cliques": 5000,
    "cliques_contados": 1742,
    "com_senha": false,
    "etiquetas": ["campanha", "email"],
    "pixels": { "meta": "123456789012345" },
    "cliques_no_mes": 318,
    "total_cliques": 1742,
    "destino_fora_do_ar": false,
    "fora_do_ar_desde": null
  }
}

Provide either id or codigo. Unknown or invalid parameters are rejected.

{
  "status": "erro",
  "mensagem": "Informe o id ou o codigo do link, um dos dois."
}

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