Como ler o campo count das categorias e etiquetas na API
Quem consulta um catálogo pela primeira vez costuma se perguntar o que significam os números que acompanham categorias e etiquetas. Este guia neutro explica como interpretar o campo count, o valor de contagem que o WordPress devolve nas consultas públicas à API REST, usando como exemplo as categorias e etiquetas consultadas no site Contos Sexuais em 28 de outubro de 2026. Não se trata de um inventário definitivo: os dados citados refletem apenas a página de resultados observada naquela data, e contagens podem mudar sempre que novas publicações são adicionadas ou reclassificadas. Para métodos mais amplos de localização de conteúdos, vale ler o guia sobre como localizar conteúdos no catálogo por categorias e etiquetas publicado no próprio site.
O que significa o campo count em uma categoria
Segundo a documentação do WordPress, cada post pode ser arquivado em uma ou mais categorias, o que ajuda na navegação. Na API REST, cada categoria é devolvida como um objeto com campos como identificador, nome, slug, link e count. O campo count representa, na definição oficial, o número de publicações associadas ao termo, e por isso serve como um termômetro do tamanho de cada agrupamento no momento da consulta. Aplicando essa leitura aos dados públicos obtidos em 28 de outubro de 2026, é possível comparar categorias entre si. Na resposta pública da API REST, o item da categoria Contos Eróticos apresenta o campo count com o valor 47. Já a categoria Uncategorized, que é criada por padrão pelo WordPress, apareceu com contagem zero na mesma resposta, o que reforça a ideia de que um termo pode existir no sistema sem ter publicações atribuídas. Outras categorias observadas na mesma página de resultados incluíam Contos Românticos, Relatos Reais, Contos Curiosos, Contos de Casadas, Contos de Escritório, Contos de Primeira Vez, Contos de Swing, Contos de Traição e Contos de Vizinhos, cada uma com sua própria contagem naquela data.
Etiquetas e a leitura do campo count
As etiquetas funcionam como descritores mais específicos, complementando as categorias com detalhes como cenário, tom ou elemento recorrente. Na API REST, as etiquetas também trazem o campo count, permitindo a mesma leitura comparativa. Na resposta pública da API REST, o item da etiqueta conto sensual apresenta o campo count com o valor 21. Na mesma página de resultados também apareceram etiquetas como sedução, contos eróticos, encontro inesperado, romance, ginásio, ficção adulta, catálogo, categorias, etiquetas, navegação, taxonomia e API REST, entre outras, cada qual com o valor de contagem registrado na data da consulta. Etiquetas como academia e contos curtos apresentavam contagem zero, um lembrete útil de que a existência de um termo no sistema não garante que existam publicações associadas a ele. Ao interpretar esses números, convém tratá-los como fotografia de um instante, e não como propriedade permanente da etiqueta ou da categoria. O guia interno sobre como consultar as taxonomias do site pela API REST do WordPress detalha o passo a passo técnico dessas consultas.
Limites da consulta e o parâmetro per_page
Toda leitura do campo count precisa respeitar os limites técnicos da própria API. A documentação oficial do WordPress avisa que o parâmetro per_page é limitado a 100 registros por pedido. Isso significa que uma consulta que solicita até 100 itens corresponde a uma única página de resultados, e não ao catálogo completo. Para coleções maiores, a documentação orienta fazer pedidos adicionais e combinar os resultados na aplicação, além de consultar os cabeçalhos de resposta que indicam o total de registros e o total de páginas disponíveis. Por prudência editorial, este guia não soma nem extrapola totais entre páginas: relatamos somente o que a página consultada devolveu na data indicada. Essa é também a razão pela qual insistimos na expressão categorias e etiquetas consultadas em 28 de outubro de 2026, em vez de falar em listagem completa do site.
Boas práticas para ler contagens com responsabilidade
Ao usar o campo count como mapa de navegação, algumas práticas ajudam a manter expectativas realistas. Primeiro, registre sempre a data da consulta, porque contagens mudam com o tempo. Segundo, prefira a leitura direta das páginas públicas de cada categoria ou etiqueta quando quiser o estado atual do catálogo, pois essas páginas são atualizadas automaticamente. Terceiro, ao usar a API, respeite o limite documentado de registros por pedido e evite pedidos desnecessários em sequência, uma recomendação explícita da documentação oficial para não prejudicar o desempenho do site. Quarto, descreva a origem e o alcance dos dados com honestidade: dizer que as categorias e etiquetas foram consultadas na data indicada é mais preciso do que apresentar qualquer contagem como se fosse definitiva. Seguindo esses cuidados, o campo count deixa de ser um número solto e passa a funcionar como um índice confiável, ainda que dinâmico, do tamanho de cada agrupamento do catálogo.