GET/v1/blogs/{subdomain}/tags

List all tags for a blog

Returns all tags that have been applied to at least one published post on this blog, ordered by usage count descending (most-used tag first). Use the `slug` field from a tag to filter posts by that tag via the `tag` query parameter of the List Posts endpoint.

Parameters

Name	In	Type	Description
`subdomain`*	path	`string`	Subdomain of the blog (e.g. `alice` for `alice.writizzy.com`)

Responses

200Tag list retrieved successfully

tagsobject[]required

Tags ordered by number of posts (most-used first)

namestringrequired

Human-readable tag name

slugstringrequired

URL-safe slug — use as the `tag` query parameter in GET /posts to filter by this tag

descriptionstringoptional

Optional description of what the tag covers

coverImageUrlstringoptional

URL of the tag's cover image

postCountinteger (int64)required

Number of published posts using this tag

Code example

GET/v1/blogs/{subdomain}/tags

curl -X GET \
  -H "Accept: application/json" \
  "http://localhost:8080/v1/blogs/<subdomain>/tags"

GET/v1/blogs/{subdomain}/tags

curl -X GET \
  -H "Accept: application/json" \
  "http://localhost:8080/v1/blogs/<subdomain>/tags"