Skip to content

Quick Start

Get up and running with the Regular Show API in just a few minutes!

Step 1: Make Your First Request

The simplest way to start is using cURL:

bash
curl https://regularshow-api.vercel.app/api

Or if you're using the production API:

bash
curl https://regularshow-api.vercel.app/api

Step 2: Get All Characters

bash
curl https://regularshow-api.vercel.app/api/character

Response:

json
{
  "info": {
    "count": 252,
    "pages": 13,
    "current_page": 1
  },
  "results": [
    {
      "id": 48814,
      "name": "Ace Balthazar",
      "slug": "Ace_Balthazar",
      "image": "images/Ace_Balthazar.png",
      ...
    },
    ...
  ]
}

Step 3: Search for a Character

Search by name:

bash
curl "https://regularshow-api.vercel.app/api/character?name=Mordecai"

Search by category:

bash
curl "https://regularshow-api.vercel.app/api/character?category=Villains"

Step 4: Get a Specific Character

By ID:

bash
curl https://regularshow-api.vercel.app/api/character/2037

By slug:

bash
curl https://regularshow-api.vercel.app/api/character/Benson

Step 5: Get Episodes

Get all episodes:

bash
curl https://regularshow-api.vercel.app/api/episode

Get episodes from a specific season:

bash
curl "https://regularshow-api.vercel.app/api/episode?season=1"

Using in JavaScript

javascript
// Fetch all characters
const response = await fetch('https://regularshow-api.vercel.app/api/character');
const data = await response.json();
console.log(data.info.count, 'characters found');

// Search for a character
const searchResponse = await fetch('https://regularshow-api.vercel.app/api/character?name=Rigby');
const searchData = await searchResponse.json();
console.log(searchData.results[0].name);

Using in Python

python
import requests

# Fetch all characters
response = requests.get('https://regularshow-api.vercel.app/api/character')
data = response.json()
print(f"{data['info']['count']} characters found")

# Search for a character
search_response = requests.get('https://regularshow-api.vercel.app/api/character', params={'name': 'Rigby'})
search_data = search_response.json()
print(search_data['results'][0]['name'])

Next Steps

Released under the MIT License.