Introduction

What is this?

The Bob's Burgers API is a REST API based on the television show Bob's Burgers. The Bob's Burgers API contains data for hundreds of characters, episodes, running gags, and images from the show.

If you are using this API please consider supporting the project by buying me a coffee to help maintain the API and keep it free for everyone.

Try it now!

https://bobsburgers-api.herokuapp.com
[]

Statistics

GraphQL

The GraphQL endpoint provides a GraphQL wrapper around the Bob's Burgers REST API. 

https://bobsburgers-api.herokuapp.com/graphql

Root URL

The Root endpoint provides information on all available resources within the API. All requests are GET requests and are sent over HTTPS. 

https://bobsburgers-api.herokuapp.com/

Example Result:

{}

Sorting and Limiting

All endpoints support the sortBy, orderBy, limit, and skip parameters.

Example Results:

Sort in ascending order:

https://bobsburgers-api.herokuapp.com/characters?sortBy=name&OrderBy=asc&limit=1&skip=0
{
  "id": 1,
  "name": "\"Dottie Minerva\"",
  "relatives": [],
  "wikiUrl": "https://bobs-burgers.fandom.com/wiki/%22Dottie_Minerva%22",
  "image": "https://bobsburgers-api.herokuapp.com/images/characters/1.jpg",
  "gender": "Female",
  "hair": "Blonde",
  "occupation": "Student at Wagstaff School",
  "allOccupations": [
    "Student at Wagstaff School"
  ],
  "firstEpisode": "\"The Kids Run the Restaurant\"",
  "voicedBy": "Wendy Molyneux",
  "url": "https://bobsburgers-api.herokuapp.com/characters/1"
}
Sort in descending order:

https://bobsburgers-api.herokuapp.com/characters?sortBy=name&OrderBy=desc&limit=1&skip=0
{
  "id": 496,
  "name": "Zeke",
  "relatives": [
    {
      "name": "Unnamed parents"
    },
    {
      "name": "Cheryl",
      "relationship": "stepmother",
      "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Cheryl",
      "url": "https://bobsburgers-api.herokuapp.com/characters/84"
    },
    {
      "name": "Unnamed 44 year old brother"
    },
    {
      "name": "Unnamed grandparents"
    },
    {
      "name": "Unnamed aunt"
    },
    {
      "name": " Leslie",
      "relationship": "cousin",
      "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Leslie",
      "url": "https://bobsburgers-api.herokuapp.com/characters/272"
    }
  ],
  "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Zeke",
  "image": "https://bobsburgers-api.herokuapp.com/images/characters/496.jpg",
  "gender": "Male",
  "age": "14",
  "occupation": "Student at Wagstaff School",
  "allOccupations": [
    "Student at Wagstaff School"
  ],
  "firstEpisode": "\"The Belchies\"",
  "voicedBy": "Bobby Tisdale",
  "url": "https://bobsburgers-api.herokuapp.com/characters/496"
}

Filtering Endpoints

All endpoints support filtering on any available key within their schema.

Example Results:

Find a character characters with Blonde hair


https://bobsburgers-api.herokuapp.com/characters?hair=Blonde&id=52

Find all episodes that aired on January 16, 2011


https://bobsburgers-api.herokuapp.com/episodes?airDate=January 16, 2011

Characters

The Characters endpoint provides information on all characters in Bob's Burgers.

Get all characters

The list of all characters can be found by using the /characters/ endpoint.


https://bobsburgers-api.herokuapp.com/characters/

Get a single character

A single character can be found by adding the id parameter to the /characters/ endpoint.


https://bobsburgers-api.herokuapp.com/characters/1
{
  "id": 1,
  "name": "\"Dottie Minerva\"",
  "relatives": [],
  "wikiUrl": "https://bobs-burgers.fandom.com/wiki/%22Dottie_Minerva%22",
  "image": "https://bobsburgers-api.herokuapp.com/images/characters/1.jpg",
  "gender": "Female",
  "hair": "Blonde",
  "occupation": "Student at Wagstaff School",
  "allOccupations": [
    "Student at Wagstaff School"
  ],
  "firstEpisode": "\"The Kids Run the Restaurant\"",
  "voicedBy": "Wendy Molyneux",
  "url": "https://bobsburgers-api.herokuapp.com/characters/1"
}

Get multiple characters

Multiple characters can be found by adding an array of ids to the /characters/ endpoint. (E.g. [1,2,3] or1,2,3 )


https://bobsburgers-api.herokuapp.com/characters/[1,2,3]
[
  {
    "id": 1,
    "name": "\"Dottie Minerva\"",
    "relatives": [],
    "wikiUrl": "https://bobs-burgers.fandom.com/wiki/%22Dottie_Minerva%22",
    "image": "https://bobsburgers-api.herokuapp.com/images/characters/1.jpg",
    "gender": "Female",
    "hair": "Blonde",
    "occupation": "Student at Wagstaff School",
    "allOccupations": [
      "Student at Wagstaff School"
    ],
    "firstEpisode": "\"The Kids Run the Restaurant\"",
    "voicedBy": "Wendy Molyneux",
    "url": "https://bobsburgers-api.herokuapp.com/characters/1"
  },
  {
    "id": 2,
    "name": "Mabel \"Abby\" Haddington",
    "relatives": [],
    "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Abby_Haddington",
    "image": "https://bobsburgers-api.herokuapp.com/images/characters/2.jpg",
    "gender": "Female",
    "hair": "Blonde",
    "age": "9-10",
    "occupation": "Student at Wagstaff School",
    "allOccupations": [
      "Student at Wagstaff School"
    ],
    "firstEpisode": "\"Slumber Party\"",
    "voicedBy": "Rachel Dratch",
    "url": "https://bobsburgers-api.herokuapp.com/characters/2"
  },
  {
    "id": 3,
    "name": "Adam",
    "relatives": [
      {
        "name": "Unnamed wife"
      }
    ],
    "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Adam",
    "image": "https://bobsburgers-api.herokuapp.com/images/characters/3.jpg",
    "gender": "Male",
    "hair": "Brown",
    "firstEpisode": "\"Mr. Lonely Farts\"",
    "voicedBy": "Brian Huskey",
    "url": "https://bobsburgers-api.herokuapp.com/characters/3"
  }
]

Characters Schema

Key
Type
Nullable
Description
idnumberThe unique id for the character
namestringThe character's name
imagestringThe url for the character's image
hairstringThe character's hair color
agestringThe character's age
genderstringThe character's gender
allOccupationsstring[]All of the character's known occupations
occupationstringThe character's occupation
relativesRelative[] (see below)The character's relatives
firstEpisodestringThe first episode the character appeared in
voicedBystringThe voice actor(s) for the character
wikiUrlstringThe unique for link the character's wiki page
urlstringThe unique for link the character

Relatives Schema

Key
Type
Nullable
Description
namestringThe relative's name
relationshipstringThe relative's relationship to the character.
wikiUrlstringThe unique for link the relative's wiki page
urlstringThe unique for link the relative

Episodes

The Episodes endpoint provides information on all episodes in Bob's Burgers.

Get all episodes

The list of all episodes can be found by using the /episodes/ endpoint.


https://bobsburgers-api.herokuapp.com/episodes/

Get a single episode

A single episode can be found by adding the id parameter to the /episodes/ endpoint.


https://bobsburgers-api.herokuapp.com/episodes/1
{
  "id": 1,
  "name": "\"Human Flesh\"",
  "description": "Bob must deal with a health inspector who pays his family's restaurant a visit after hearing a rumor from his youngest daughter.",
  "productionCode": "1ASA01",
  "airDate": "January 9, 2011",
  "season": 1,
  "episode": 1,
  "totalViewers": "9.38 Million",
  "url": "https://bobsburgers-api.herokuapp.com/episodes/1",
  "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Human_Flesh"
}

Get multiple episodes

Multiple episodes can be found by adding an array of ids to the /episodes/ endpoint. (E.g. [1,2,3] or1,2,3 )


https://bobsburgers-api.herokuapp.com/episodes/[1,2,3]
[
  {
    "id": 1,
    "name": "\"Human Flesh\"",
    "description": "Bob must deal with a health inspector who pays his family's restaurant a visit after hearing a rumor from his youngest daughter.",
    "productionCode": "1ASA01",
    "airDate": "January 9, 2011",
    "season": 1,
    "episode": 1,
    "totalViewers": "9.38 Million",
    "url": "https://bobsburgers-api.herokuapp.com/episodes/1",
    "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Human_Flesh"
  },
  {
    "id": 2,
    "name": "\"Crawl Space\"",
    "description": "Bob dreads Linda's mom's visit. Linda is trying to keep the apartment pristine, and when she gets Bob to fix a leak in the roof, Bob gets trapped. Linda and the kids must deal with their visitors and the restaurant alone.",
    "productionCode": "1ASA02",
    "airDate": "January 16, 2011",
    "season": 1,
    "episode": 2,
    "totalViewers": "5.07 Million",
    "url": "https://bobsburgers-api.herokuapp.com/episodes/2",
    "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Crawl_Space"
  },
  {
    "id": 3,
    "name": "\"Sacred Cow\"",
    "description": "Customers start avoiding Bob's Burgers when a controversial documentary filmmaker puts a cow outside it. Bob's discontent with the cow turns into attachment, and he starts acting like it is a family member.",
    "productionCode": "1ASA04",
    "airDate": "January 23, 2011",
    "season": 1,
    "episode": 3,
    "totalViewers": "4.81 Million",
    "url": "https://bobsburgers-api.herokuapp.com/episodes/3",
    "wikiUrl": "https://bobs-burgers.fandom.com/wiki/Sacred_Cow"
  }
]

Episodes Schema

Key
Type
Nullable
Description
idnumberThe unique id for the episode
namestringThe episode's name
descriptionstringThe episode's description
productionCodestringThe episode's production code
airDatestringThe episode's air date
seasonnumberThe season the episode appeared in
episodenumberThe episode number in the season
totalViewersstringThe episode's total viewers
urlstringThe unique link for the episode
wikiUrlstringThe unique for link the episodes's wiki page

Store Next Door

The Store Next Door endpoint provides information on all storefronts next to Bob's Burgers.

Get all stores next door

The list of all stores next door can be found by using the /storeNextDoor/ endpoint.


https://bobsburgers-api.herokuapp.com/storeNextDoor/

Get a single store next door

A single store next door can be found by adding the id parameter to the /storeNextDoor/ endpoint.


https://bobsburgers-api.herokuapp.com/storeNextDoor/1
{
  "id": 1,
  "name": "P.F.E.T.A",
  "image": "https://bobsburgers-api.herokuapp.com/images/storeNextDoor/1.jpg",
  "season": 1,
  "episode": 1,
  "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
  "url": "https://bobsburgers-api.herokuapp.com/storeNextDoor/1"
}

Get multiple stores next door

Multiple stores next door can be found by adding an array of ids to the /storeNextDoor/ endpoint. (E.g. [1,2,3] or1,2,3 )


https://bobsburgers-api.herokuapp.com/storeNextDoor/[1,2,3]
[
  {
    "id": 1,
    "name": "P.F.E.T.A",
    "image": "https://bobsburgers-api.herokuapp.com/images/storeNextDoor/1.jpg",
    "season": 1,
    "episode": 1,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
    "url": "https://bobsburgers-api.herokuapp.com/storeNextDoor/1"
  },
  {
    "id": 2,
    "name": "Trot's All Natural Fertilizer",
    "image": "https://bobsburgers-api.herokuapp.com/images/storeNextDoor/2.jpg",
    "season": 1,
    "episode": 2,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/2",
    "url": "https://bobsburgers-api.herokuapp.com/storeNextDoor/2"
  },
  {
    "id": 3,
    "name": "RENT REDUCED: Crime Scene Special",
    "image": "https://bobsburgers-api.herokuapp.com/images/storeNextDoor/3.jpg",
    "season": 1,
    "episode": 3,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/3",
    "url": "https://bobsburgers-api.herokuapp.com/storeNextDoor/3"
  }
]

Store Next Door Schema

Key
Type
Nullable
Description
idnumberThe unique id for the store
namestringThe store's name
imageurlThe url for the store's image
seasonnumberThe season that the store appeared in
episodenumberThe episode that the store appeared in
episodeUrlurlThe url for the episode that the store appeared in
urlurlThe unique link for the store

Pest Control Truck

The Pest Control Truck endpoint provides information on all pest control trucks inBob's Burgers.

Get all pest control trucks

The list of all pest control trucks can be found by using the /pestControlTruck/ endpoint.


https://bobsburgers-api.herokuapp.com/pestControlTruck/

Get a single pest control truck

A single pest control truck can be found by adding the id parameter to the /pestControlTruck/ endpoint.


https://bobsburgers-api.herokuapp.com/pestControlTruck/1
{
  "id": 1,
  "name": "Rat's all Folks! EXTERMINATORS",
  "image": "https://bobsburgers-api.herokuapp.com/images/pestControlTruck/1.jpg",
  "season": 1,
  "episode": 1,
  "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
  "url": "https://bobsburgers-api.herokuapp.com/pestControlTruck/1"
}

Get multiple pest control trucks

Multiple pest control trucks can be found by adding an array of ids to the /pestControlTruck/ endpoint. (E.g. [1,2,3] or1,2,3 )


https://bobsburgers-api.herokuapp.com/pestControlTruck/[1,2,3]
[
  {
    "id": 1,
    "name": "Rat's all Folks! EXTERMINATORS",
    "image": "https://bobsburgers-api.herokuapp.com/images/pestControlTruck/1.jpg",
    "season": 1,
    "episode": 1,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
    "url": "https://bobsburgers-api.herokuapp.com/pestControlTruck/1"
  },
  {
    "id": 2,
    "name": "Rat's all Folks! EXTERMINATORS",
    "image": "https://bobsburgers-api.herokuapp.com/images/pestControlTruck/2.jpg",
    "season": 1,
    "episode": 2,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/2",
    "url": "https://bobsburgers-api.herokuapp.com/pestControlTruck/1"
  },
  {
    "id": 3,
    "name": "Rat's all Folks! EXTERMINATORS",
    "image": "https://bobsburgers-api.herokuapp.com/images/pestControlTruck/3.jpg",
    "season": 1,
    "episode": 3,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/3",
    "url": "https://bobsburgers-api.herokuapp.com/pestControlTruck/1"
  }
]

Pest Control Truck Schema

Key
Type
Nullable
Description
idnumberThe unique id for the pest control truck
namestringThe pest control truck's name
imagestringThe url for the pest control truck's image
seasonnumberThe season that the pest control truck appeared in
episodenumberThe episode that the pest control truck appeared in
episodeUrlstringThe url for the episode that the pest control truck appeared in.
urlstringThe unique link for the pest control truck

End Credits Sequence

The End Credits Sequence endpoint provides information on all end credits sequences inBob's Burgers.

Get all end credits sequences

The list of all end credits sequences can be found by using the /endCreditsSequence/ endpoint.


https://bobsburgers-api.herokuapp.com/endCreditsSequence/

Get a single end credits sequence

A single end credits sequence can be found by adding the id parameter to the /endCreditsSequence/ endpoint.


https://bobsburgers-api.herokuapp.com/endCreditsSequence/1
{
  "id": 1,
  "image": "https://bobsburgers-api.herokuapp.com/images/endCreditsSequence/1.jpg",
  "season": 1,
  "episode": 1,
  "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
  "url": "https://bobsburgers-api.herokuapp.com/endCreditsSequence/1"
}

Get multiple end credits sequences

Multiple end credits sequences can be found by adding an array of ids to the /endCreditsSequence/ endpoint. (E.g. [1,2,3] or1,2,3 )


https://bobsburgers-api.herokuapp.com/endCreditsSequence/[1,2,3]
[
  {
    "id": 1,
    "image": "https://bobsburgers-api.herokuapp.com/images/endCreditsSequence/1.jpg",
    "season": 1,
    "episode": 1,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
    "url": "https://bobsburgers-api.herokuapp.com/endCreditsSequence/1"
  },
  {
    "id": 2,
    "image": "https://bobsburgers-api.herokuapp.com/images/endCreditsSequence/2.jpg",
    "season": 1,
    "episode": 2,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/2",
    "url": "https://bobsburgers-api.herokuapp.com/endCreditsSequence/2"
  },
  {
    "id": 3,
    "image": "https://bobsburgers-api.herokuapp.com/images/endCreditsSequence/3.jpg",
    "season": 1,
    "episode": 3,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/3",
    "url": "https://bobsburgers-api.herokuapp.com/endCreditsSequence/3"
  }
]

End Credits Sequence Schema

Key
Type
Nullable
Description
idnumberThe unique id for the end credits sequence.
imagestringThe url for the end credits sequence's image
seasonnumberThe season that the end credits sequence appeared in
episodenumberThe episode that the end credits sequence appeared in
episodeUrlstringThe url for the episode that the end credits sequence appeared in
urlstringThe unique link for the end credits sequence

Burger of The Day

The Burger of The Day endpoint provides information on all burgers of the day in Bob's Burgers.

Get all burgers of the day

The list of all burgers of the day can be found by using the /burgerOfTheDay/ endpoint.


https://bobsburgers-api.herokuapp.com/burgerOfTheDay/

Get a single burger of the day

A single burger of the day can be found by adding the id parameter to the /burgerOfTheDay/ endpoint.


https://bobsburgers-api.herokuapp.com/burgerOfTheDay/1
{
  "id": 1,
  "name": "\"New Bacon-ings\" - Comes with Bacon",
  "price": "$5.95",
  "season": 1,
  "episode": 1,
  "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
  "url": "https://bobsburgers-api.herokuapp.com/burgerOfTheDay/1"
}

Get multiple burgers of the day

Multiple burgers of the day can be found by adding an array of ids to the /burgerOfTheDay/ endpoint. (E.g. [1,2,3] or1,2,3 )


https://bobsburgers-api.herokuapp.com/burgerOfTheDay/[1,2,3]
[
  {
    "id": 1,
    "name": "\"New Bacon-ings\" - Comes with Bacon",
    "price": "$5.95",
    "season": 1,
    "episode": 1,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
    "url": "https://bobsburgers-api.herokuapp.com/burgerOfTheDay/1"
  },
  {
    "id": 2,
    "name": "The Child Molester - Comes with Candy!",
    "price": "$5.95",
    "season": 1,
    "episode": 1,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/1",
    "url": "https://bobsburgers-api.herokuapp.com/burgerOfTheDay/1"
  },
  {
    "id": 3,
    "name": "Foot Feta-ish Burger",
    "price": "$5.95",
    "season": 1,
    "episode": 2,
    "episodeUrl": "https://bobsburgers-api.herokuapp.com/episodes/2",
    "url": "https://bobsburgers-api.herokuapp.com/burgerOfTheDay/2"
  }
]

Burger of The Day Schema

Key
Type
Nullable
Description
idnumberThe unique id for the burger of the day
namestringThe name of the burger of the day
pricestringThe price for the burger of the day
seasonnumberThe season that the burger of the day appeared in
episodenumberThe episode that the burger of the day appeared in
episodeUrlstringThe url for the episode that the burger of the day appeared in
urlstringThe unique link for the burger of the day
Buy Me a Coffee

Created by Zachary Spielberger 2022