Episodes Endpoint

Get information about all Breaking Bad with optional filtering and pagination.

get

https://api.mridul.tech/api/breaking-bad/episodes

Get information about all Breaking Bad with optional filtering and pagination.

Overview

This endpoint returns a comprehensive list of all episodes from both Breaking Bad and Better Call Saul. Each episode includes detailed information such as title, air date, season and episode numbers, and the characters that appear in that episode.

Rate Limiting

2000 requests per 24 hours per IP address

Episode Coverage

5 Seasons
62 Episodes
2008-2013

Features

Filter by series, season, or episode number
Pagination support with limit and offset
Episode titles and air dates
Character appearances per episode

Parameter	Type	Required	Description	Example
`season`	`string`	Optional	Filter episodes by season number Default: Default: All seasons	`1`

Example Requests

Get all episodes

GET https://api.mridul.tech/api/breaking-bad/episodes

Get Season 1 episodes

GET https://api.mridul.tech/api/breaking-bad/episodes?season=1

Code Examples

JavaScript (Fetch)

fetch("https://api.mridul.tech/api/breaking-bad/episodes?season=1")
  .then((response) => response.json())
  .then((data) => {
    console.log(`Found ${data.count} episodes`);
    data.data.forEach((episode) => {
      console.log(`S${episode.season}E${episode.episode}: ${episode.title}`);
    });
  });

Python (requests)

import requests

response = requests.get('https://api.mridul.tech/api/breaking-bad/episodes?season=1')
data = response.json()

if data['success']:
  print(f"Found {data['count']} episodes")
  for episode in data['data']:
    print(f"S{episode['season']}E{episode['episode']}: {episode['title']}")

cURL

curl "https://api.mridul.tech/api/breaking-bad/episodes?season=1"

Response Format

Success Response (200)

{
  "success": true,
  "data": [
    {
      "episode_id": "101",
      "title": "Pilot",
      "season": "1",
      "air_date": "January 20, 2008",
      "characters": [
        "Walter White",
        "Jesse Pinkman",
        "Skyler White",
        "Hank Schrader",
        "Marie Schrader",
        "Walter White Jr.",
        "Krazy-8",
        "Bogdan Wolynetz"
      ],
      "episode": "1",
      "series": "Breaking Bad",
      "id": 1
    },
    {
      "episode_id": "102",
      "title": "Cat's in the Bag...",
      "season": "1",
      "air_date": "January 27, 2008",
      "characters": [
        "Walter White",
        "Jesse Pinkman",
        "Skyler White",
        "Walter White Jr.",
        "Krazy-8"
      ],
      "episode": "2",
      "series": "Breaking Bad",
      "id": 2
    }
  ]
}

Response Fields

Field	Type	Description
`episode_id`	`integer`	Unique episode identifier
`title`	`string`	Episode title
`season`	`string`	Season number
`air_date`	`string`	Original air date in MM-DD-YYYY format
`characters`	`array`	List of main characters appearing in the episode
`episode`	`string`	Episode number within the season
`series`	`string`	Series name (Breaking Bad or Better Call Saul)

Error Response (400/404/429/500)

{
  "success": false,
  "error": "Error message description",
  "statusCode": 400
}

Single Character Single Episode Endpoint