Hashnode

Hashnode

Developer blogging platform: publications, posts, drafts, tags, and series.

Data Model

• Publications — blogs owned by users; every post belongs to a publication. Identified by host (e.g. username.hashnode.dev).
• Posts — published articles with Markdown content, tags, canonical URL, SEO metadata.
• Drafts — unpublished posts; require publicationId to create.
• Tags — taxonomy for posts; referenced by slug or name.
• Series — ordered groups of related posts within a publication.

Key Patterns

• Pagination: Cursor style (edges/nodes/pageInfo) for long lists.
• Publication required: Drafts and publishes need a publication context—resolve the right publication id from your account metadata first.
• Tags: Use { slug: "tag-slug", name: "Tag Name" } format — no IDs needed for new tags.
• Canonical URL: Set via originalArticleURL field (not canonicalUrl which is read-only).
• SEO: Use metaTags input for custom title/description meta tags.

Gotchas

• Rate limit: 20k queries/min, 500 mutations/min.
• originalArticleURL is the input field for canonical URL; canonicalUrl is the read-only response field.
• A publication must exist before creating drafts or posts.
• Hashnode allow-lists publications individually for API access. The PAT is fine on its own; the publication is the unit Hashnode allow-lists. Non-allow-listed publications are blocked at the edge before the origin sees the token. Onboarding goes through hello+support@hashnode.com with your publication domain.