JSONKit
Content

Blog Post JSON Example

A complete JSON example for a blog post content type — includes title, slug, author, tags, SEO meta, and rich body fields. Copy-ready for headless CMS and content API design.

{
  "id": "post_6Rk3mNpQxT",
  "slug": "how-to-use-json-in-rest-apis",
  "title": "How to Use JSON in REST APIs: A Complete Guide",
  "excerpt": "Learn how to structure JSON request and response bodies for clean, consistent REST APIs.",
  "body": "<h2>Introduction</h2><p>JSON (JavaScript Object Notation) has become the de-facto format for REST API payloads...</p>",
  "author": {
    "id": "usr_9k2mXpQr4t",
    "name": "Ravi Mehta",
    "avatarUrl": "https://cdn.example.com/avatars/usr_9k2mXpQr4t.jpg",
    "bio": "Senior Backend Engineer at TechCraft, Ahmedabad."
  },
  "categories": [
    "APIs",
    "JSON",
    "Backend Development"
  ],
  "tags": [
    "rest",
    "json",
    "api-design",
    "backend",
    "tutorial"
  ],
  "status": "published",
  "featuredImage": {
    "url": "https://cdn.example.com/blog/json-rest-apis.jpg",
    "alt": "JSON code on a dark background",
    "width": 1200,
    "height": 630
  },
  "seo": {
    "metaTitle": "How to Use JSON in REST APIs: A Complete Guide",
    "metaDescription": "Step-by-step guide to structuring JSON payloads for REST APIs. Covers request bodies, response envelopes, error formats, and pagination.",
    "canonicalUrl": "https://blog.example.com/how-to-use-json-in-rest-apis",
    "openGraphImage": "https://cdn.example.com/blog/json-rest-apis-og.jpg"
  },
  "readingTimeMinutes": 8,
  "viewCount": 14320,
  "likeCount": 287,
  "commentsEnabled": true,
  "publishedAt": "2025-03-15T09:00:00Z",
  "updatedAt": "2025-04-01T12:00:00Z",
  "createdAt": "2025-03-10T15:00:00Z"
}

Field Reference

idrequiredstringUnique post identifier with post_ prefix
slugrequiredstringURL-safe identifier derived from the title, used in permalink
statusrequiredstringLifecycle state: draft, scheduled, published, or archived
authorrequiredobjectEmbedded author object with id, name, avatar, and bio
bodyrequiredstringHTML or Markdown body content of the post
seooptionalobjectSEO overrides for meta title, description, canonical, and Open Graph
readingTimeMinutesoptionalintegerEstimated reading time in minutes, auto-calculated from word count
publishedAtoptionalstring (ISO 8601)Timestamp when the post became publicly visible

Variants

MinimalDraft post with only required content fields, no SEO or analytics data.
{
  "id": "post_1Bn4pQmZrX",
  "slug": "getting-started-with-typescript",
  "title": "Getting Started with TypeScript",
  "excerpt": "A beginner's introduction to TypeScript types, interfaces, and configuration.",
  "body": "<p>TypeScript is a typed superset of JavaScript...</p>",
  "author": {
    "id": "usr_3hFwLmNz8q",
    "name": "Priya Sharma"
  },
  "categories": [
    "TypeScript",
    "Programming"
  ],
  "tags": [
    "typescript",
    "beginner"
  ],
  "status": "draft",
  "commentsEnabled": true,
  "createdAt": "2025-05-18T10:00:00Z",
  "updatedAt": "2025-05-18T10:00:00Z"
}
ExtendedPublished post with full SEO, schema markup, related posts, and engagement stats.
{
  "id": "post_6Rk3mNpQxT",
  "slug": "how-to-use-json-in-rest-apis",
  "title": "How to Use JSON in REST APIs: A Complete Guide",
  "excerpt": "Learn how to structure JSON request and response bodies for clean, consistent REST APIs.",
  "body": "<h2>Introduction</h2><p>JSON (JavaScript Object Notation) has become the de-facto format for REST API payloads...</p>",
  "author": {
    "id": "usr_9k2mXpQr4t",
    "name": "Ravi Mehta",
    "avatarUrl": "https://cdn.example.com/avatars/usr_9k2mXpQr4t.jpg",
    "bio": "Senior Backend Engineer at TechCraft, Ahmedabad."
  },
  "categories": [
    "APIs",
    "JSON",
    "Backend Development"
  ],
  "tags": [
    "rest",
    "json",
    "api-design",
    "backend",
    "tutorial"
  ],
  "status": "published",
  "featuredImage": {
    "url": "https://cdn.example.com/blog/json-rest-apis.jpg",
    "alt": "JSON code on a dark background",
    "width": 1200,
    "height": 630
  },
  "seo": {
    "metaTitle": "How to Use JSON in REST APIs: A Complete Guide",
    "metaDescription": "Step-by-step guide to structuring JSON payloads for REST APIs.",
    "canonicalUrl": "https://blog.example.com/how-to-use-json-in-rest-apis",
    "openGraphImage": "https://cdn.example.com/blog/json-rest-apis-og.jpg"
  },
  "schemaOrg": {
    "@context": "https://schema.org",
    "@type": "BlogPosting",
    "headline": "How to Use JSON in REST APIs: A Complete Guide",
    "author": {
      "@type": "Person",
      "name": "Ravi Mehta"
    }
  },
  "relatedPostIds": [
    "post_2Cm5rSnYpZ",
    "post_3Dn6tToZqA"
  ],
  "readingTimeMinutes": 8,
  "viewCount": 14320,
  "likeCount": 287,
  "commentsEnabled": true,
  "publishedAt": "2025-03-15T09:00:00Z",
  "updatedAt": "2025-04-01T12:00:00Z",
  "createdAt": "2025-03-10T15:00:00Z"
}

Common Use Cases

  • →Defining the content schema for a headless CMS like Contentful, Sanity, or a custom API
  • →Rendering blog post pages in a Next.js or Nuxt application from an API response
  • →Indexing blog content into Algolia or Elasticsearch for full-text search
blogCMScontentSEOheadless

Validate or format this JSON

One click loads this exact example into the tool — no copy-paste needed. Format it, validate it, explore the tree, or generate TypeScript types instantly.

FormatValidateExplore treeGenerate TypeScriptMinify

Frequently Asked Questions

Markdown is more portable and easier to version-control, while HTML offers richer layout control. Many headless CMSs use a structured rich-text format (like Portable Text or Lexical) that serializes to both.

Use status: 'scheduled' and set publishedAt to a future ISO 8601 timestamp. The publishing service checks this field and flips status to 'published' at the specified time.

Group all SEO overrides under a nested 'seo' object with metaTitle, metaDescription, canonicalUrl, and openGraphImage. This keeps the top-level schema clean and lets SEO fields be optional.

Related JSON Examples

ContentSocial Media PostSocial feed post with media, reactions, reshares, and thread metadata.ContentPush NotificationPush notification with title, body, deep-link data, and platform-specific options.API DesignREST API ResponseGeneric REST API response wrapper with data payload, status, and pagination meta.