Simpsons API
Updates
- 2026-10-12 - Disneyplus changed their uuids for seasons 1-32, near as I can tell; they also seem to have changed their url structure. This update should get the random/good episode redirects back in business. Also adds release dates, writers, guest stars, directors; changes some descriptions to full instead of short; adds seasons 36 and 37.
- 2026-02-01 - started tracking updates. Slight update to this here page. Added base data for seasons 33, 34, 35.
About
This is a minimal Simpsons JSON and redirect API based on the dataset over here. It redirects you to the episode on Disney+, or serves up some basic episode JSON about episodes (if you set the right headers).
A login to Disney+ is necessary, but they give you a free preview, so hey.
I made this because there are some outstanding Simpsons episodes and some very bad ones. This lets you click the "Show me a random episode" button without fear that you're going to have to accidentally wind up on All Singing, All Dancing.
How to use
Some endpoints of interest:
- Get redirected to a good episode at /episodes/good/ and a random episode at /episodes/random/.
- Point your browser at /episodes/s/{SEASON_NUMBER}/e/{EPISODE_NUMBER}/ to go to that episode.
- Request any episodes url with headers `Accept: application/json` to get some data back as json. Try it out: `curl -H "Accept: application/json" https://www.simpsonsoptimizer.com/episodes/s/5/e/2/`
- Request /episodes/s/{SEASON_NUMBER}/ to get season data back as json.
- Still extremely a work in progress so don't get any URLs tattooed on you or anything.
If you want to complain that I marked your favorite episode as bad, please make a pull request or open an issue.
Originally made by Colin in 2019.