APOD Entry

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/nasa-apod/main/json-schema/apod-entry.json",
  "title": "APOD Entry",
  "description": "A single Astronomy Picture of the Day entry returned by the NASA APOD API",
  "type": "object",
  "required": ["date", "title", "explanation", "url", "media_type", "service_version"],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date of the APOD entry in YYYY-MM-DD format",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "example": "2014-10-01"
    },
    "title": {
      "type": "string",
      "description": "The title of the astronomy image or video",
      "minLength": 1,
      "example": "Filaments of the Vela Supernova Remnant"
    },
    "explanation": {
      "type": "string",
      "description": "Detailed explanation of the astronomy picture or video written by NASA scientists",
      "minLength": 1
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The URL of the APOD image or video of the day"
    },
    "hdurl": {
      "type": "string",
      "format": "uri",
      "description": "The URL for any high-resolution image. Omitted if it does not exist originally at APOD or if media_type is video."
    },
    "media_type": {
      "type": "string",
      "description": "The type of media returned",
      "enum": ["image", "video"]
    },
    "service_version": {
      "type": "string",
      "description": "The service version used to fulfill the request",
      "example": "v1"
    },
    "copyright": {
      "type": "string",
      "description": "The name of the copyright holder. Absent if the image is NASA/public domain.",
      "example": "Panther Observatory"
    },
    "concepts": {
      "description": "An ordered dictionary of concepts derived from the APOD explanation text. Only returned when concept_tags=True.",
      "oneOf": [
        {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        {
          "type": "string",
          "description": "String message returned when concept tagging is disabled"
        }
      ],
      "example": {
        "0": "Astronomy",
        "1": "Star",
        "2": "Sun",
        "3": "Milky Way"
      }
    },
    "thumbnail_url": {
      "type": "string",
      "format": "uri",
      "description": "The URL of the video thumbnail. Only present when thumbs=True and media_type is 'video'."
    },
    "resource": {
      "type": "object",
      "description": "A dictionary describing the image_set or planet that the response illustrates",
      "properties": {
        "image_set": {
          "type": "string",
          "example": "apod"
        }
      }
    },
    "concept_tags": {
      "type": ["boolean", "string"],
      "description": "Reflection of the supplied concept_tags option. Included in response because of default values.",
      "example": false
    }
  },
  "examples": [
    {
      "date": "2014-10-01",
      "title": "Filaments of the Vela Supernova Remnant",
      "explanation": "The explosion is over but the consequences continue.",
      "url": "https://apod.nasa.gov/apod/image/1310/velafilaments_jadescope_960.jpg",
      "hdurl": "https://apod.nasa.gov/apod/image/1310/velafilaments_jadescope_2000.jpg",
      "media_type": "image",
      "service_version": "v1"
    }
  ]
}