APOD API

Astronomy Picture of the Day, served from NASA's APOD feeds. Compatible with the original NASA APOD API; no API key required..

Endpoint

GET https://apod-api.sudos.site/v1/apod/

With no parameters, returns the current APOD as a JSON object. Requests that ask for several APODs (start_date, count) return a JSON array.

Parameter	Type	Description
`date`	YYYY-MM-DD	The APOD for this date. Earliest is 1995-06-16.
`start_date`	YYYY-MM-DD	Start of a date range. Cannot be combined with `date` or `count`.
`end_date`	YYYY-MM-DD	End of a date range (defaults to today). Ranges are limited to 366 days.
`count`	integer	Return this many random APODs (1–100). Cannot be combined with dates.
`random`	boolean	Return one random APOD, or `count` random APODs.
`thumbs`	boolean	Add `thumbnail_url` for YouTube video APODs.
`markdown`	flag	Return links in `explanation`, `copyright` and `editor` as markdown `[text](url)` instead of plain text.
`concept_tags`	boolean	Not supported; adds a `concepts` notice.
`hd`, `api_key`	—	Accepted for compatibility with the NASA API and ignored.

Booleans accept true, 1 or yes. Flags can also be passed bare, e.g. &markdown. Any other parameter returns a 400.

Field	Description
`date`	APOD date, YYYY-MM-DD.
`title`	APOD title.
`explanation`	Explanation text.
`media_type`	`image`, `video` or `other`.
`url`	Image or video URL.
`hdurl`	Full-resolution image URL (images only).
`thumbnail_url`	Video thumbnail, when `thumbs` is set and one is available.
`copyright`	Image or video credit, or `null`.
`editor`	That day's editor, or `null` for archive posts that don't name one.
`article_url`	The APOD article on science.nasa.gov.

Errors return JSON with the matching HTTP status:

{ "msg": "No data available for date: 2026-12-25", "code": 404 }

400 for invalid parameters or combinations, 404 when no APOD exists for the date, 500 for upstream failures.