GET/v1/blogs/{subdomain}

Get blog metadata

Returns the public metadata for a blog: display name, description, language, logo, cover image, author profile, and ordered navigation menu.

This is typically the first call a headless front-end makes to bootstrap itself. The url field contains the canonical base URL of the blog (custom domain when configured, or the default {subdomain}.writizzy.com URL otherwise). Use it to construct absolute links to posts and pages.

Parameters

subdomainpathstringrequired

Subdomain of the blog (e.g. alice for alice.writizzy.com). Also accepts the subdomain of a blog configured with a custom domain.

Responses

200

Blog metadata retrieved successfully

namestringrequired

Blog display name

subdomainstringrequired

Writizzy subdomain (e.g. 'alice' for alice.writizzy.com)

urlstringrequired

Canonical public URL of the blog (custom domain if configured, subdomain URL otherwise)

taglinestringoptional

Short tagline displayed in the blog header

descriptionstringoptional

Longer description of the blog, suitable for SEO meta tags

languagestringrequired

BCP 47 language tag for the blog's primary content language (e.g. 'en', 'fr')

timezonestringrequired

IANA timezone identifier used for publication dates (e.g. 'Europe/Paris', 'UTC')

logoUrlstringoptional

URL of the blog logo image

coverImageUrlstringoptional

URL of the blog cover / hero image

authorobjectrequired

Public profile of the blog owner

5 properties

namestringrequired

Display name of the author

avatarUrlstringoptional

URL of the author's avatar image

biostringoptional

Full biography of the author (may contain Markdown)

shortBiostringoptional

Short one-line biography suitable for bylines

socialsobject[]required

List of social media profile links

2 properties

platformstringrequired

Platform identifier (e.g. twitter, linkedin, github, mastodon)

urlstringrequired

Full URL of the social profile

navigationobject[]required

Ordered list of navigation menu items configured by the blog owner

2 properties

labelstringrequired

Display label for the navigation link

urlstringrequired

URL the navigation item points to (relative for internal pages, absolute for external links)

Code example

GET/v1/blogs/{subdomain}

curl -X GET \
  -H "Accept: application/json" \
  "https://api.writizzy.com/v1/blogs/<subdomain>"

GET/v1/blogs/{subdomain}

curl -X GET \
  -H "Accept: application/json" \
  "https://api.writizzy.com/v1/blogs/<subdomain>"