Como acompanhar mudanças nas contagens de categorias e etiquetas
Por que acompanhar contagens em vez de só listar termos
Os guias já publicados neste site explicam como consultar as taxonomias pela API REST e como localizar conteúdos por categorias e etiquetas. Este artigo assume um objetivo diferente: guardar respostas da API em datas distintas e comparar os números de associação de cada termo ao longo do tempo. Trata-se de um caso de uso de metadados, sem qualquer descrição de conteúdo editorial dos textos indexados.
A ideia central é simples: cada termo de categoria ou etiqueta traz, na resposta da API, um campo numérico que muda quando novas publicações recebem aquele termo. Guardando snapshots datados, você pode detectar quais termos cresceram, quais ficaram estáveis e quais zeraram desde a última consulta.
O que cada campo da resposta significa
No esquema da API REST do WordPress, o campo count representa o número de publicações publicadas associadas ao termo. Os demais campos pedidos na consulta pública são igualmente documentados:
| Campo | Significado documentado |
|---|---|
| id | Identificador numérico único do termo |
| name | Título do termo exibido no site |
| slug | Identificador alfanumérico usado nas URLs |
| link | URL pública do arquivo do termo |
| count | Número de publicações publicadas do termo |
Para deixar o formato concreto, um único item da resposta de categorias se apresenta assim, exatamente como chega da API:
{"count": 45, "id": 2, "link": "https://contossexuais.com/category/contos-eroticos/", "name": "Contos Eróticos", "slug": "contos-eroticos"}No snapshot consultado na data atual, a categoria Contos Eróticos aparece com contagem igual a 45. Esse número é um ponto de partida: o valor que interessa é sempre o da data em que você repete a consulta.
Categoria e etiqueta na prática do monitoramento
Os dois endpoints retornam a mesma estrutura de campos, mas servem a taxonomias distintas do WordPress. A tabela resume as diferenças relevantes para quem vai indexar as duas coleções:
| Aspecto | Categorias | Etiquetas |
|---|---|---|
| Endpoint | /wp-json/wp/v2/categories | /wp-json/wp/v2/tags |
| Esquema de campos | id, name, slug, link, count, entre outros | id, name, slug, link, count, entre outros |
| Comportamento típico | Conjunto menor e mais estável de termos amplos | Conjunto maior de termos descritivos por publicação |
No mesmo snapshot de etiquetas, a etiqueta conto sensual aparece com contagem igual a 21. Comparado ao valor de uma consulta futura, esse registro permite estimar quantas novas publicações receberam a etiqueta no intervalo.
Limites do snapshot e paginação
As consultas usadas como referência nesta página são um recorte delimitado: categorias e etiquetas consultadas na data atual, em uma única página de resultados. Elas não representam o catálogo inteiro, e nenhuma soma entre páginas deve ser inferida. O parâmetro per_page é limitado a 100 registros por requisição, e a documentação orienta combinar várias requisições para montar listas maiores no aplicativo. A própria documentação de paginação sugere esse caminho para construir, por exemplo, uma lista com todas as categorias disponíveis no lado do cliente.
Para saber quanto ainda falta recuperar, a API envia em cada resposta paginada dois cabeçalhos: X-WP-Total, com o total de registros da coleção, e X-WP-TotalPages, com o total de páginas disponíveis. Com esses cabeçalhos, seu script decide se precisa solicitar a página seguinte antes de salvar o snapshot.
Um fluxo de trabalho simples de comparação
Um processo enxuto para acompanhar mudanças tem quatro passos, todos baseados apenas em endpoints públicos documentados:
- Solicite categorias e etiquetas salvando a data da consulta junto da resposta.
- Indexe cada termo pela chave id, preservando name, slug, link e count.
- Na consulta seguinte, compare o count atual com o valor anterior e registre a diferença por termo.
- Guarde as mudanças observadas em uma tabela de histórico, sem extrapolar para totais não consultados.
Termos com contagem zero também são informativos: eles indicam identificadores que existem na taxonomia, mas não têm publicações associadas no momento da consulta. Um zero que virava número positivo, ou o contrário, é exatamente o tipo de mudança que o histórico revela.