NASA APOD · Schema

APOD Entry

A single Astronomy Picture of the Day entry returned by the NASA APOD API

NASAAstronomySpaceImagesScienceEducationOpen Data

Properties

Name	Type	Description
date	string	Date of the APOD entry in YYYY-MM-DD format
title	string	The title of the astronomy image or video
explanation	string	Detailed explanation of the astronomy picture or video written by NASA scientists
url	string	The URL of the APOD image or video of the day
hdurl	string	The URL for any high-resolution image. Omitted if it does not exist originally at APOD or if media_type is video.
media_type	string	The type of media returned
service_version	string	The service version used to fulfill the request
copyright	string	The name of the copyright holder. Absent if the image is NASA/public domain.
concepts	object	An ordered dictionary of concepts derived from the APOD explanation text. Only returned when concept_tags=True.
thumbnail_url	string	The URL of the video thumbnail. Only present when thumbs=True and media_type is 'video'.
resource	object	A dictionary describing the image_set or planet that the response illustrates
concept_tags	booleanstring	Reflection of the supplied concept_tags option. Included in response because of default values.

View JSON Schema on GitHub

JSON Schema

{
  "$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"
    }
  ]
}