Developer API
Build with the 2 Dads 1 Movie API. Access episode data, film metadata, ratings, cast info, transcripts, and more.
What You Can Build
Discord & Chat Bots
"What film was on episode 47?" — build a bot that answers instantly using the episodes and films endpoints.
Film Data & Analysis
Host ratings, box office data, critic scores, and genres across 100+ episodes — perfect for data journalism and film analysis.
Widgets & Extensions
Embed episode info, ratings comparisons, or cast data in browser extensions, websites, or dashboards.
Transcript Search
Search what Steve and Nic actually said — full transcript search with timestamps and speaker attribution.
Quick Start
Base URL
List Episodes
Get a Film
Search
Example Response
{
"episodes": [
{
"id": "...",
"episode_number": 42,
"title": "The Matrix",
"published_on": "2024-06-15",
"film": {
"title": "The Matrix",
"release_year": 1999,
"poster_url": "https://..."
},
"tags": [
{ "name": "Sci-Fi", "tag_type": "genre" }
]
}
],
"meta": { "total": 120, "page": 1, "per_page": 25 }
}
Available Endpoints
| Endpoint | Description |
|---|---|
| GET /api/v1/episodes | List published episodes with film and tag data |
| GET /api/v1/episodes/:id | Episode detail (by ID or slug) |
| GET /api/v1/episodes/:id/transcript | Full transcript with speakers and timestamps |
| GET /api/v1/films | List films with ratings, financials, and credits |
| GET /api/v1/films/:id | Film detail with full cast/crew credits |
| GET /api/v1/people | List actors, directors, writers, and composers |
| GET /api/v1/people/:id | Person detail with full filmography |
| GET /api/v1/tags | List genres, themes, and tropes |
| GET /api/v1/tags/:id | Tag detail |
| GET /api/v1/search?q=... | Search across episodes, people, and transcripts |
Details
No Auth Required
All read endpoints are public. No API key needed to get started.
JSON Responses
All responses are JSON with consistent structure. Paginated lists include a meta object.
Caching
Responses include ETag and Last-Modified headers. Use conditional requests to save bandwidth.
Rate Limits
120 requests per minute per IP. Generous for reads. You'll get a 429 if you exceed it.
Filtering & Sorting
Filter by year, tag, MPAA rating, and more. Sort with ?sort=-release_year (prefix with - for descending).
Friendly IDs
Use slugs like the-matrix-1999 or UUIDs — both work for lookups.
For full request/response schemas, try-it-out testing, and parameter details:
Open Interactive API Docs