outubro 26, 2026

Como decidir o caminho no catálogo usando contagens da API

Leitor decidindo entre caminhos de navegação em um catálogo online

Quando você quer achar uma leitura específica no catálogo do site, existem três caminhos possíveis: abrir o arquivo de uma categoria, abrir o arquivo de uma etiqueta ou digitar palavras na busca livre. Escolher o caminho errado costuma custar mais tempo do que a própria leitura. Este guia apresenta um critério de decisão simples, baseado em contagens que a API pública do site devolve para qualquer pessoa, sem cadastro e sem ferramentas especiais — basta abrir um endereço no navegador.

Por que a decisão depende da contagem

A API pública do WordPress devolve, para cada categoria e cada etiqueta, o número de publicações associadas ao termo. É essa contagem que separa um caminho bom de um caminho ruim. Uma categoria com poucas dezenas de itens funciona como uma estante pequena: você folheia tudo. Uma etiqueta com meia dúzia de itens funciona como uma gaveta: você abre e encontra. Já a busca livre serve para quando você lembra uma palavra, mas não sabe se ela virou categoria, etiqueta ou nem uma coisa nem outra.

No manual oficial, o campo count é definido como o número de publicações do termo. Isso significa que a contagem que você consulta não é uma estimativa nem um número inventado pelo navegador: é o mesmo valor que o sistema guarda para cada termo. Quando maior for a contagem, mais motivos você tem para refinar com uma segunda pista antes de começar a folhear.

As contagens que a API devolve hoje

Para montar o critério, consultamos as categorias e etiquetas na data de hoje, 26 de outubro de 2026, apenas na primeira página de cada lista pública — uma fotografia limitada, que não descreve o catálogo inteiro nem soma totais entre páginas. Os endereços consultados estão na seção de fontes, e qualquer leitor pode repetir a consulta. A resposta da API registra a categoria Contos Eróticos com o identificador 62 e a contagem de 40 publicações. No mesmo inventário, a etiqueta conto erótico aparece com 39 itens, enquanto a vizinha contos eróticos soma 12.

Termo Tipo Identificador Itens
Contos Eróticos Categoria 62 40
conto erótico Etiqueta 7 39
contos eróticos Etiqueta 63 12
catálogo Etiqueta 240 8
consentimento Etiqueta 190 7

Repare na armadilha da sinonímia: singular e plural viram etiquetas diferentes, com contagens muito distantes. Se você abrir só a etiqueta plural, deixa de ver os 39 itens do singular. Quando duas etiquetas vizinhas existirem, o critério honesto é escolher a de contagem maior ou conferir as duas.

O critério de decisão em três passos

Primeiro passo: se o termo que você lembra aparece como categoria com contagem alta — dezenas de itens —, trate a categoria como ponto de partida, nunca como destino final. Segundo passo: escolha uma etiqueta que apareça com contagem pequena, de um dígito, e abra o arquivo dela a partir da página da categoria; a interseção informal das duas listas reduz o trabalho. Terceiro passo: se nada disso funcionar, use a busca livre com a palavra exata, porque ela atravessa categorias e etiquetas ao mesmo tempo. Quem quiser evitar as confusões mais comuns nesse percurso pode ler o guia sobre erros comuns ao filtrar leituras.

O que fazer quando o termo não aparece

Se a palavra que você digitou não vier na lista da primeira página, ainda existem duas saídas legítimas antes de desistir. O limite de 100 registros por página é um teto documentado da própria API do WordPress. Isso significa que uma lista pode continuar em páginas seguintes, e você não deve concluir que o termo não existe só porque ele não apareceu na primeira olhada. Além disso, a documentação oficial orienta usar os cabeçalhos de resposta, como o total de registros da coleção, para saber quanto material ainda falta examinar — um jeito de dimensionar a busca sem somar números na cabeça.

Em resumo: contagem alta pede uma segunda pista, contagem baixa convida a abrir o arquivo direto, e termo ausente pede paciência com a paginação antes de trocar de palavra. Com o critério deste guia, a escolha entre categoria, etiqueta e busca livre deixa de ser um palpite e passa a ser uma decisão apoiada em números públicos que qualquer leitor pode conferir.

Fontes