Interface ou API: dois caminhos para navegar pelo catálogo
A categoria Contos Eróticos apareceu com contagem de 46 publicações na página de categorias consultada. A etiqueta conto sensual apareceu, na mesma consulta, com contagem de 21 publicações. Esses dois números, lidos diretamente do campo de contagem devolvido pelos endpoints públicos de taxonomia do WordPress, abrem a pergunta central deste guia: para explorar o catálogo, vale mais a pena usar a interface do site ou consultar a API? A resposta curta é que os dois caminhos se complementam, e este texto mostra exatamente quando cada um rende mais. Todo o percurso usa como referência as categorias e etiquetas consultadas na data atual, 26 de outubro de 2026, acessíveis a partir da página inicial do site.
O que cada caminho entrega de melhor
A interface do site é o caminho natural para a leitura: clicar em um link de categoria, percorrer a página de arquivo e abrir uma publicação são gestos imediatos, que não exigem nenhuma ferramenta além do navegador. Já a consulta pública à API REST é o caminho natural para a comparação: em uma única resposta, ela devolve nomes, identificadores, links e contagens de muitos termos ao mesmo tempo, permitindo enxergar a distribuição do catálogo antes de escolher onde entrar. Tratar os dois como concorrentes é um erro comum; o ganho real aparece quando eles são usados em sequência, com a API servindo de mapa e a interface servindo de destino.
O recorte observado é limitado por definição: a API devolve coleções paginadas, e este artigo se apoia apenas na primeira página de resultados de cada endpoint, obtida sem autenticação. Nenhuma enumeração aqui deve ser lida como o catálogo completo do site, e nenhum total deve ser presumido entre páginas. O que o recorte oferece é um conjunto de contagens comparáveis entre si na mesma data, suficiente para decidir por onde começar a navegação.
| Termo | Tipo | Contagem observada |
|---|---|---|
| Contos Eróticos | Categoria | 46 |
| conto sensual | Etiqueta | 21 |
Os dois valores da tabela vêm literalmente do campo de contagem dos itens retornados na primeira página de cada endpoint. A diferença entre eles já ensina algo: um mesmo tema pode aparecer com pesos distintos conforme o eixo escolhido, e por isso comparar antes de clicar economiza tempo de leitura.
Como a API sustenta a comparação
A documentação oficial do WordPress estabelece que o parâmetro per_page é limitado a 100 registros por requisição. Isso significa que coleções maiores precisam ser percorridas em várias páginas, o que mantém o caráter de instantâneo parcial de qualquer consulta única. Para saber quanto ainda falta, a API informa cabeçalhos de totalização de registros e de páginas, permitindo continuar a navegação de forma controlada sem presumir totais entre páginas.
Os endpoints de categorias e etiquetas oferecem o parâmetro hide_empty para ocultar termos sem publicações atribuídas. Combinado com o campo de contagem, esse filtro permite montar visões enxutas para análise: em vez de listar termos vazios, a leitura se concentra nos termos que de fato reúnem publicações. Outros parâmetros públicos úteis incluem a busca por texto livre, a ordenação por atributos do termo e a filtragem por slug, todos descritos no manual oficial da API REST. Ao compor a URL da consulta, cada parâmetro é acrescentado após o endereço do endpoint, seguindo as regras de concatenação documentadas.
Um percurso completo: da contagem ao arquivo público
Um exercício prático mostra o fluxo híbrido em ação. Primeiro, escolha um termo com contagem relevante no recorte consultado, como a etiqueta de maior contagem da página de etiquetas. Segundo, observe o campo de link do item retornado pela API: ele aponta para a página de arquivo pública daquele termo, pronta para visita. Terceiro, abra essa página no navegador e confira as publicações listadas. Quarto, repita o processo com a categoria correspondente e compare as duas listas, aproveitando justamente a diferença de contagens observada. O roteiro de quatro passos, termo, contagem, link e arquivo, transforma metadados em navegação concreta.
Segundo a documentação do WordPress.com, o WordPress gera automaticamente uma página de arquivo para cada categoria do site. Essas páginas são atualizadas a cada nova publicação atribuída ao termo, o que as torna o destino natural dos links observados nos resultados da API. Um percurso análogo funciona partindo da categoria de maior contagem do recorte, como a página de arquivo de Contos Eróticos.
Quando usar cada caminho e como registrar o resultado
Em resumo, use a interface quando o objetivo for descoberta casual, leitura imediata e exploração por cliques; use a API quando o objetivo for comparar contagens entre muitos termos, detectar padrões de distribuição e repetir a mesma pergunta em datas diferentes. Vale ainda registrar a data de cada consulta, pois as contagens mudam com novas publicações, e um comparativo sem data perde valor rapidamente. Independentemente do caminho escolhido, o princípio permanece o mesmo: cada afirmação sobre o catálogo deve se apoiar no que a resposta pública realmente devolveu, e o conjunto consultado deve ser sempre descrito como um recorte no tempo, não como o estado definitivo do site.