Link shortener

List links

List links with pagination, search, and per-person filtering for company tokens.

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

Returns links accessible to the token, ordered from newest to oldest. Each item includes the link details, its creator, and the current month's click count.

Pagination and search

Use pagina to select a page, starting at 1, and por_pagina to request between 1 and 100 items per page. The defaults are page 1 and 20 items.

busca accepts up to 100 characters and searches the title, destination URL, and link code without case sensitivity. Search and other filters also apply to the total result count.

Filter by person

With a company token, send usuario to list one person's links. Use the ID from criado_por.id or the pessoas list in Account summary.

A personal token already restricts results to its issuer's links; sending usuario returns HTTP 400.

Filter by tag

Send etiqueta with a tag of 1 to 30 characters to list the links that have it, without case sensitivity. The filter also applies to the total. A blank value or one longer than 30 characters returns HTTP 400.

Paginated response

Field	Description
`total`	Number of links matching the search and filters.
`pagina`	Requested page number, starting at 1.
`por_pagina`	Maximum number of items per page.
`itens`	Links on this page. Each item contains the fields from Create a link plus `cliques_no_mes`.

If there are no results or the requested page is beyond the last page, itens is an empty array. See Pagination and filters for retrieving all pages and handling links created during a query.

Parameters

Header

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

Query parameters

paginainteger: Page number, starting at 1. Default: 1.
por_paginainteger: Number of links per page, from 1 to 100. Default: 20.
buscastring: Text up to 100 characters to search the title, destination, and code.
usuariointeger: ID of the person whose links to list. Available only with a company token.
etiquetastring: Tag of 1 to 30 characters to filter by, case insensitive.

Request example

curl -sS "https://pqno.app/admin/api/encurtar-link/meuslinks?pagina=1&por_pagina=50" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const links = new Map();
for (let pagina = 1; ; pagina++) {
  const url = new URL('https://pqno.app/admin/api/encurtar-link/meuslinks');
  url.search = new URLSearchParams({ pagina: String(pagina), por_pagina: '100' });
  const resposta = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.PQNO_TOKEN}` }
  });
  const json = await resposta.json();
  if (!resposta.ok || json.status !== 'ok') throw new Error(json.mensagem);
  const { itens, total, por_pagina } = json.dados;
  for (const link of itens) links.set(link.id, link);
  if (itens.length === 0 || pagina * por_pagina >= total) break;
}
console.log([...links.values()]);

<?php
$query = http_build_query(['busca' => 'campanha', 'por_pagina' => 50]);
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/meuslinks?' . $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'] ?? '');
}
foreach ($json['dados']['itens'] as $link) {
    echo $link['url_curta'], ' ', $link['cliques_no_mes'], PHP_EOL;
}

import os
import requests

resposta = requests.get(
    'https://pqno.app/admin/api/encurtar-link/meuslinks',
    headers={'Authorization': f"Bearer {os.environ['PQNO_TOKEN']}"},
    params={'pagina': 1, 'por_pagina': 50},
    timeout=30,
)
corpo = resposta.json()
if corpo['status'] != 'ok':
    raise RuntimeError(corpo['mensagem'])
for link in corpo['dados']['itens']:
    print(link['url_curta'], link['cliques_no_mes'])

Responses

Results page containing total, pagina, por_pagina, and itens.

{
  "status": "ok",
  "dados": {
    "total": 57,
    "pagina": 1,
    "por_pagina": 2,
    "itens": [
      {
        "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": null,
        "max_cliques": null,
        "cliques_contados": 0,
        "com_senha": false,
        "etiquetas": ["campanha", "email"],
        "pixels": { "meta": "123456789012345" },
        "cliques_no_mes": 318
      },
      {
        "id": 4790,
        "codigo": "k7p2x9",
        "url_curta": "https://pqno.app/k7p2x9",
        "url": "https://exemplo.com.br/cardapio",
        "titulo": "Cardápio",
        "descricao": "QR Code das mesas",
        "criado_em": "2026-09-28T09:05:44-03:00",
        "criado_por": { "id": 52, "nome": "Rafael Lima" },
        "expira_em": null,
        "max_cliques": null,
        "cliques_contados": 0,
        "com_senha": true,
        "etiquetas": [],
        "pixels": {},
        "cliques_no_mes": 1204
      }
    ]
  }
}

Invalid or unknown parameter, or usuario filter used with a personal token.

{
  "status": "erro",
  "mensagem": "O parâmetro por_pagina deve ser um número inteiro de 1 a 100."
}

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