Blog Taxonomy Counts Endpoint

Last updated: January 26, 2026

Route

GET /wp-json/extrachill/v1/blog/taxonomy-counts

Returns taxonomy term counts and archive URLs from the main blog site (Blog ID resolved via ec_get_blog_id( 'main' )).

This endpoint is used by cross-site taxonomy linking and other consumers that need consistent counts without manual switch_to_blog() logic.

Public (permission_callback is __return_true).

Parameter	Type	Required	Description
`taxonomy`	string	Yes	Taxonomy slug to query. The handler checks `taxonomy_exists()` in the blog context.
`slug`	string	No	If provided, returns a single term result for the given term slug.
`limit`	integer	No	Max results for bulk requests (default `8`, max `50`).

Returns a single object or null.

{
  "slug": "some-slug",
  "name": "Some Name",
  "count": 12,
  "url": "https://extrachill.com/artist/some-slug/"
}

Returns an array of term objects, sorted by count descending, truncated to limit.

[
  { "slug": "...", "name": "...", "count": 123, "url": "https://..." }
]

500 blog_site_unavailable when the blog ID cannot be resolved (requires ec_get_blog_id()).

Counting is performed in blog context using WP_Query + tax_query and returns found_posts.