Spaceflight News API Article

Schema for a spaceflight news article returned by the Spaceflight News API

NewsSpaceSpaceflightMedia

Properties

Name Type Description
id integer Unique identifier for the article
title string Headline of the news article
authors array List of authors who contributed to this article
url string Link to the full article on the original publication site
image_url string URL of the featured image for this article
news_site string Name of the publishing news organization
summary string Brief summary or excerpt of the article content
published_at string ISO 8601 timestamp of when the article was originally published
updated_at string ISO 8601 timestamp of the last update to this record
featured boolean Whether this article is featured or highlighted
launches array Launch Library 2 launches related to this article
events array Launch Library 2 events related to this article
View JSON Schema on GitHub

JSON Schema

spaceflight-news-api-article-schema.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/spaceflight-news-api/refs/heads/main/json-schema/spaceflight-news-api-article-schema.json",
  "title": "Spaceflight News API Article",
  "description": "Schema for a spaceflight news article returned by the Spaceflight News API",
  "type": "object",
  "properties": {
    "id": {
      "description": "Unique identifier for the article",
      "type": "integer",
      "example": 25801
    },
    "title": {
      "description": "Headline of the news article",
      "type": "string",
      "example": "NASA adjusts ISS flight schedule for upcoming missions"
    },
    "authors": {
      "description": "List of authors who contributed to this article",
      "type": "array",
      "items": {
        "$ref": "#/definitions/Author"
      }
    },
    "url": {
      "description": "Link to the full article on the original publication site",
      "type": "string",
      "format": "uri"
    },
    "image_url": {
      "description": "URL of the featured image for this article",
      "type": "string",
      "format": "uri"
    },
    "news_site": {
      "description": "Name of the publishing news organization",
      "type": "string",
      "example": "NASA"
    },
    "summary": {
      "description": "Brief summary or excerpt of the article content",
      "type": "string"
    },
    "published_at": {
      "description": "ISO 8601 timestamp of when the article was originally published",
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "description": "ISO 8601 timestamp of the last update to this record",
      "type": "string",
      "format": "date-time"
    },
    "featured": {
      "description": "Whether this article is featured or highlighted",
      "type": "boolean"
    },
    "launches": {
      "description": "Launch Library 2 launches related to this article",
      "type": "array",
      "items": {
        "$ref": "#/definitions/LaunchRef"
      }
    },
    "events": {
      "description": "Launch Library 2 events related to this article",
      "type": "array",
      "items": {
        "$ref": "#/definitions/EventRef"
      }
    }
  },
  "definitions": {
    "Author": {
      "title": "Author",
      "description": "An author who contributed to an article or blog post",
      "type": "object",
      "properties": {
        "name": {
          "description": "Full name of the author",
          "type": "string"
        },
        "socials": {
          "description": "Social media links for the author",
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        }
      }
    },
    "LaunchRef": {
      "title": "Launch Reference",
      "description": "Reference to a Launch Library 2 launch linked to a news item",
      "type": "object",
      "properties": {
        "launch_id": {
          "description": "Unique Launch Library 2 launch UUID",
          "type": "string",
          "format": "uuid"
        },
        "provider": {
          "description": "Launch service provider name",
          "type": "string"
        }
      }
    },
    "EventRef": {
      "title": "Event Reference",
      "description": "Reference to a Launch Library 2 event linked to a news item",
      "type": "object",
      "properties": {
        "event_id": {
          "description": "Unique Launch Library 2 event ID",
          "type": "integer"
        },
        "provider": {
          "description": "Event provider name",
          "type": "string"
        }
      }
    }
  }
}