Como consultar as taxonomias do site pela API REST do WordPress

Resposta direta: como consultar agora

Para consultar categorias e etiquetas, abra https://contossexuais.com/wp-json/wp/v2/categories e https://contossexuais.com/wp-json/wp/v2/tags diretamente no navegador. Cada endereço devolve uma lista em JSON com os campos id, name, slug, link e count de cada termo. Com o link você chega à página pública do termo; com o count você vê quantas publicações estão atribuídas a ele. As versões completas usadas nesta verificação, com os parâmetros de campos e de paginação, estão citadas na seção de fontes ao final do artigo.

Este guia descreve apenas as categorias e as etiquetas consultadas na data desta verificação, ou seja, um retrato limitado da primeira página de cada endpoint. Não é possível afirmar que esses termos formam o catálogo inteiro do site, porque a API pode ter páginas adicionais, como explicado na seção sobre paginação. Sempre que um número importa, ele foi copiado exatamente do campo count da resposta, nunca dos parâmetros do URL.

Passo a passo e exemplo real de resposta

1. Abra o navegador em qualquer dispositivo conectado à internet; não é preciso fazer login nem instalar nada.
2. Cole o endereço completo do endpoint de categorias e pressione Enter.
3. Localize, na lista retornada, o termo desejado e copie o valor do campo link.
4. Abra esse link em uma nova aba para ver a página pública do termo.
5. Repita o mesmo processo com o endpoint de etiquetas quando quiser termos mais específicos.

Um item real da resposta de categorias, consultado publicamente, tem esta aparência:

{
  "count": 44,
  "id": 2,
  "link": "https://contossexuais.com/category/contos-eroticos/",
  "name": "Contos Eróticos",
  "slug": "contos-eroticos"
}

Na consulta pública do endpoint de categorias, a categoria Contos Eróticos aparece com 44 publicações registradas no campo count. Já entre as etiquetas, o termo com maior contagem observado nesta página foi conto sensual. A etiqueta conto sensual aparece com 21 itens no campo count da resposta pública do endpoint de etiquetas. Outras categorias visíveis na mesma página incluem Contos de Vizinhos, com 3 publicações, e Relatos Reais, com 1 publicação, sempre segundo o valor literal do campo count de cada item.

Categorias x etiquetas: tabela comparativa

A documentação da API define o campo slug como um identificador alfanumérico único para cada termo. O slug é o valor que aparece no endereço público do termo, enquanto o name é o título exibido aos leitores. Clicar no link de uma categoria abre uma página de arquivo com todas as publicações dessa categoria. Isso significa que a navegação pode começar tanto pela home do site, em contossexuais.com, quanto pelo resultado cru da API, que sempre traz o endereço pronto de cada termo. Para um panorama editorial sobre o tema, vale ler também o guia interno categorias e etiquetas: como navegar pelo catálogo do site.

Paginação, limites e checklist final

A documentação oficial do WordPress informa que o parâmetro per_page é limitado a 100 registros por requisição. Para coleções maiores, a recomendação oficial é fazer várias requisições e combinar os resultados na sua aplicação. A API ainda devolve dois cabeçalhos úteis em cada resposta paginada: X-WP-Total, com o total de registros da coleção, e X-WP-TotalPages, com o total de páginas disponíveis. É por isso que este artigo não soma contagens nem afirma totais do site: os valores citados valem apenas para os itens efetivamente observados na página consultada.

Checklist resumido para repetir a verificação:

• Confirmar a data da consulta, porque termos e contagens mudam com novas publicações.
• Registrar o endpoint exato usado, incluindo a página consultada.
• Copiar números apenas do campo count de cada item, nunca do URL.
• Verificar os cabeçalhos de paginação antes de tirar conclusões sobre o tamanho do catálogo.
• Guardar o link de cada termo para checagem direta no site público.

Fontes

• Endpoint público de categorias (JSON)
• Endpoint público de etiquetas (JSON)
• REST API Handbook: Categories
• REST API Handbook: Tags
• REST API Handbook: Pagination
• Posts Categories screen (WordPress.org)
• Organize posts with categories (WordPress.com)