Home/Breaking Bad API/Characters Endpoint

Characters Endpoint

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

get

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

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

Overview

This endpoint returns a comprehensive list of all Breaking Bad characters. Each character includes detailed information such as name, birthday, occupation, status, and appearance data.

Rate Limiting

2000 requests per 24 hours per IP address

⚠️ Content Warning

This endpoint contains information about character deaths and may include spoilers for the Breaking Bad series.

Character Information Includes

Full name and birthday
Current status (alive, deceased, etc.)
Occupation(s) and nickname
High-quality character image
Season appearances and actor information

Features

Filter by character name
Pagination support with limit and offset
Detailed character information, including images
Season appearance tracking

Query Parameters

Parameter	Type	Required	Description	Example
`limit`	`integer`	Optional	Number of characters to return (1-100) Default: Default: All characters	`10`
`offset`	`integer`	Optional	Number of characters to skip for pagination Default: Default: 0	`20`
`name`	`string`	Optional	Filter characters by name (case insensitive) Default: Default: None	`Walter White`

Example Requests

Get all characters

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

Get first 10 characters

GET https://api.mridul.tech/api/breaking-bad/characters?limit=10

Search by character name

GET https://api.mridul.tech/api/breaking-bad/characters?name=Walter

Combined filters

GET https://api.mridul.tech/api/breaking-bad/characters?limit=5&offset=10

Code Examples

JavaScript (Fetch)

fetch("https://api.mridul.tech/api/breaking-bad/characters?limit=10")
  .then((response) => response.json())
  .then((data) => console.log(data));

Python (requests)

import requests 
response = requests.get('https://api.mridul.tech/api/breaking-bad/characters?limit=10') 
data = response.json() 
print(data)

cURL

curl "https://api.mridul.tech/api/breaking-bad/characters?limit=10"

Response Format

Success Response (200)

{
  "success": true,
  "data": [
    {
      "name": "Walter White",
      "portrayed": "Bryan Cranston",
      "image_url": "https://static.wikia.nocookie.net/breakingbad/images/e/e7/BB-S5B-Walt-590.jpg",
      "full_name": "Walter Hartwell White Sr.",
      "birth_date": "September 7, 1958",
      "occupation": [
        "Co-Founder, Gray Matter Technologies",
        "Chemist, Sandia Laboratories",
        "Chemistry Teacher, J. P. Wynne High School (former)",
        "Crystal Meth Manufacturer (former)",
        "Drug Kingpin (former)",
        "Co-Owner, A1A Car Wash (former)",
        "Co-Owner, Vamonos Pest (former)"
      ],
      "episodes_count": "62",
      "series": "Breaking Bad",
      "appearances": ["1", "2", "3", "4", "5a", "5b"],
      "id": 1
    },
    {
      "name": "Jesse Pinkman",
      "portrayed": "Aaron Paul",
      "image_url": "https://static.wikia.nocookie.net/breakingbad/images/9/95/JesseS5.jpg",
      "full_name": "Jesse Bruce Pinkman (\"Down\")",
      "birth_date": "September 24, 1983",
      "occupation": ["Methamphetamine manufacturer & distributor (former)"],
      "episodes_count": "62",
      "series": "Breaking Bad",
      "appearances": ["1", "2", "3", "4", "5a", "5b"],
      "id": 2
    }
  ]
}

Response Fields

Field	Type	Description
`id`	`integer`	Unique character identifier
`name`	`string`	Character's full name
`portrayed`	`string`	Actor who portrayed the character
`episodes_count`	`string`	Breaking Bad episodes character appeared in
`birthday`	`string`	Character's birthday in MM-DD-YYYY format
`occupation`	`array`	List of character's occupations
`image_url`	`string`	URL to character's image
`appearances`	`array`	Season list, the character appeared in
`series`	`string`	Name of the series

Error Response (400/404/429/500)

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

Back to API Overview Single Character Endpoint