Characters

The Characters endpoint provides access to all characters from the Regular Show animated series.

Endpoint

GET /api/character

Query Parameters

Parameter	Type	Description
name	string	Filter by character name
slug	string	Filter by character slug
category	string	Filter by category (e.g., "Villains", "Main Characters")
page	number	Page number (default: 1)
limit	number	Results per page (default: 20)

Get All Characters

GET /api/character

Search Characters by Name

GET /api/character?name=Mordecai

Filter by Category

GET /api/character?category=Villains
GET /api/character?category=Main%20Characters
GET /api/character?category=Antagonists

Pagination

GET /api/character?page=2&limit=10

Get Single Character

GET /api/character/:id

Parameters:

• id - Character ID or slug

GET /api/character/2037
GET /api/character/Benson

Character Object

{
  "id": 2037,
  "name": "Benson",
  "slug": "Benson",
  "image": "images/Benson.png",
  "categories": [
    "Characters",
    "Featured Articles",
    "Main Characters",
    "Male Characters",
    "Park Workers"
  ],
  "info": {
    "Home": "The House",
    "Occupation": "Park Manager",
    "Status": "Alive",
    "Gender": "Male",
    "Relatives": [
      "Unnamed parents",
      "Unnamed sister",
      "Pam (wife)"
    ],
    "Voiced_by": "Sam Marin"
  },
  "index": "B"
}

Available Categories

Here are some of the categories available for filtering:

• Main Characters - Primary characters in the show
• Recurring Characters - Characters that appear frequently
• Minor Characters - Characters with limited appearances
• Villains - Antagonists
• Animals - Animal characters
• Aliens - Alien characters
• Robots - Robot characters
• Deceased Characters - Characters who have died

Get Character Image Only

GET /api/character/:id/image

GET /api/character/Benson/image

Response:

{
  "id": 2037,
  "name": "Benson",
  "image": "images/Benson.png"
}

Example: Get All Main Characters

async function getMainCharacters() {
  const response = await fetch('https://regularshow-api.vercel.app/api/character?category=Main%20Characters');
  const data = await response.json();
  return data.results;
}

Example: Search and Display Characters

async function searchCharacters(query) {
  const response = await fetch(
    `https://regularshow-api.vercel.app/api/character?name=${query}&limit=20`
  );
  const data = await response.json();
  
  data.results.forEach(character => {
    console.log(`${character.name} (${character.slug})`);
    console.log(`  Categories: ${character.categories.join(', ')}`);
  });
}

searchCharacters('Mor');