Spaceflight News Paginated Blog List Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/spaceflight-news/refs/heads/main/json-structure/spaceflight-news-paginated-blog-list-structure.json",
  "name": "PaginatedBlogList",
  "description": "Paginated envelope wrapping a page of blog posts.",
  "type": "object",
  "properties": {
    "count": {
      "type": "int32",
      "description": "Total number of blog posts matching the query.",
      "example": 1995
    },
    "next": {
      "type": "uri",
      "nullable": true,
      "description": "URL to fetch the next page of results, or null on the last page.",
      "example": "https://api.spaceflightnewsapi.net/v4/blogs/?limit=10&offset=20"
    },
    "previous": {
      "type": "uri",
      "nullable": true,
      "description": "URL to fetch the previous page of results, or null on the first page.",
      "example": "https://api.spaceflightnewsapi.net/v4/blogs/?limit=10&offset=0"
    },
    "results": {
      "type": "array",
      "description": "The current page of blog posts.",
      "items": {
        "type": "object",
        "description": "A spaceflight blog post (longform commentary or analysis) from a participating publisher.",
        "properties": {
          "id": {
            "type": "int32",
            "readOnly": true,
            "description": "Unique identifier of the blog post.",
            "example": 2277
          },
          "title": {
            "type": "string",
            "maxLength": 250,
            "description": "Title of the blog post.",
            "example": "United Launch Alliance Precisely Delivers Seventh Amazon Leo Mission"
          },
          "authors": {
            "type": "array",
            "description": "List of authors who contributed to the blog post.",
            "items": {
              "type": "object",
              "description": "Author byline for an article, blog, or report.",
              "properties": {
                "name": {
                  "type": "string",
                  "maxLength": 250,
                  "description": "Display name of the author.",
                  "example": "Will Robinson-Smith"
                },
                "socials": {
                  "$ref": "#/components/schemas/Socials"
                }
              },
              "required": [
                "name"
              ]
            }
          },
          "url": {
            "type": "uri",
            "maxLength": 200,
            "description": "Canonical URL of the blog post on the source publisher.",
            "example": "https://blog.ulalaunch.com/blog/seventh-amazon-leo-mission"
          },
          "image_url": {
            "type": "uri",
            "maxLength": 500,
            "description": "URL to a cover/header image for the blog post.",
            "example": "https://blog.ulalaunch.com/hubfs/av_leo7_l4_media.jpg"
          },
          "news_site": {
            "type": "string",
            "readOnly": true,
            "description": "Display name of the publisher.",
            "example": "United Launch Alliance"
          },
          "summary": {
            "type": "string",
            "description": "Short summary of the blog post.",
            "example": "ULA has launched the majority of Amazon Leo satellites on orbit."
          },
          "published_at": {
            "type": "datetime",
            "description": "ISO 8601 timestamp when the blog post was originally published.",
            "example": "2026-05-30T01:40:06Z"
          },
          "updated_at": {
            "type": "datetime",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the blog post was last updated in SNAPI.",
            "example": "2026-05-30T01:50:20.401325Z"
          },
          "featured": {
            "type": "boolean",
            "description": "Whether the blog post is featured.",
            "example": false
          },
          "launches": {
            "type": "array",
            "description": "Related Launch Library 2 launches.",
            "items": {
              "type": "object",
              "description": "Relationship to a Launch Library 2 launch.",
              "properties": {
                "launch_id": {
                  "type": "uuid",
                  "description": "Launch Library 2 launch UUID.",
                  "example": "f33d5ece-e825-4cd8-809f-1d4c72a2e0d3"
                },
                "provider": {
                  "type": "string",
                  "readOnly": true,
                  "description": "Source provider of the related launch (typically Launch Library 2).",
                  "example": "Launch Library 2"
                }
              },
              "required": [
                "launch_id",
                "provider"
              ]
            }
          },
          "events": {
            "type": "array",
            "description": "Related Launch Library 2 events.",
            "items": {
              "type": "object",
              "description": "Relationship to a Launch Library 2 event (e.g. EVA, docking, milestone).",
              "properties": {
                "event_id": {
                  "type": "int32",
                  "maximum": 2147483647,
                  "minimum": -2147483648,
                  "description": "Launch Library 2 event identifier.",
                  "example": 851
                },
                "provider": {
                  "type": "string",
                  "readOnly": true,
                  "description": "Source provider of the related event (typically Launch Library 2).",
                  "example": "Launch Library 2"
                }
              },
              "required": [
                "event_id",
                "provider"
              ]
            }
          }
        },
        "required": [
          "authors",
          "events",
          "id",
          "image_url",
          "launches",
          "news_site",
          "published_at",
          "summary",
          "title",
          "updated_at",
          "url"
        ]
      }
    }
  },
  "required": [
    "count",
    "results"
  ]
}