adventure time api

Documentation

This RESTful API is focused around Adventure Time's Characters and Episodes. Species and Occupations resources are also available, but they mainly exist to support the Characters resource. API calls will return data in JSON format.

Authentication

No authentication is required for use. That being said, to prevent too many requests to handle, each user is throttled at a maximum of 1500 requests per day.

Characters

Characters contain the bulkiest of all the information

Sample Request

GET http://adventuretimeapi.com/api/v1/characters/7/

            
{
    "id": 7,
    "name": "Lumpy Space King",
    "full_name": "Lumpy Space King",
    "sex": "Male",
    "link": "http://adventuretime.wikia.com/wiki/Lumpy_Space_King",
    "image": "http://img3.wikia.nocookie.net/__cb20120918033037/adventuretimewithfinnandjake/images/1/13/Lumpy_Space_Parents.png",
    "created": "2015-07-20T07:01:40.853033Z",
    "modified": "2015-07-20T07:03:05.725891Z",
    "episode": [
        {
            "id": 27,
            "title": "The Eyes"
        },
        {
            "id": 56,
            "title": "The Monster"
        },
        {
            "id": 1,
            "title": "Trouble in Lumpy Space"
        },
        {
            "id": 18,
            "title": "The Duke"
        },
        {
            "id": 174,
            "title": "The Prince Who Wanted Everything"
        }
    ],
    "species": [
        {
            "id": 38,
            "name": "Lumpy Space Person"
        }
    ],
    "relatives_many": [
        {
            "id": 3,
            "name": "Lumpy Space Princess"
        },
        {
            "id": 8,
            "name": "Lumpy Space Queen"
        },
        {
            "id": 406,
            "name": "Lumpy Space Prince"
        }
    ],
    "occupations": [
        {
            "id": 57,
            "title": "King"
        }
    ]
}
            
        

Fields

Field Type Description
id int Id given to this character within this API's database
name str Name of character
full_name str Full name of character
sex str Sex of character
link str Link to character's bio on adventuretime.wikia.com
image str Link to character's image from it's adventuretime.wikia.com bio
created str UTC time in which this character was created in the database
modified str UTC time in which this character was modified in the database
episode array List of character's major episode appearances
species array List of character's species, both former and present
relatives_many array List of character's relatives
occupations array List of character's occupations, both former and present

Species

Species refers to a character's species. Some species may have many characters associated with it.

Sample Request

GET http://adventuretimeapi.com/api/v1/species/1/

            
{
    "id": 1,
    "name": "Humanoid",
    "created": "2015-07-20T07:02:43.644420Z",
    "modified": "2015-07-20T07:02:43.644436Z",
    "characters": [
        {
            "id": 104,
            "name": "Penny"
        },
        {
            "id": 184,
            "name": "Kim"
        },
        {
            "id": 639,
            "name": "Sparkle's mother"
        },
        {
            "id": 662,
            "name": "Tonya"
        },
        {
            "id": 398,
            "name": "Abracadaniel"
        },
        {
            "id": 865,
            "name": "Bandito"
        },
        {
            "id": 451,
            "name": "Big Clown Nurse"
        },
        {
            "id": 877,
            "name": "Bugbear"
        },
        {
            "id": 219,
            "name": "Cobbler"
        },
        {
            "id": 108,
            "name": "Crossbow Guy"
        },
        {
            "id": 109,
            "name": "Cyclops"
        },
        {
            "id": 302,
            "name": "Doctor Princess"
        },
        {
            "id": 937,
            "name": "Sheriff"
        },
        {
            "id": 638,
            "name": "Sparkle"
        },
        {
            "id": 714,
            "name": "Slider Guys"
        },
        {
            "id": 663,
            "name": "Squeez-E-Mart boss"
        },
        {
            "id": 99,
            "name": "Tiffany"
        },
        {
            "id": 967,
            "name": "Unnamed Bath Boy Gang members"
        },
        {
            "id": 977,
            "name": "Wizard (character)"
        },
        {
            "id": 488,
            "name": "Family"
        },
        {
            "id": 222,
            "name": "Fine Lady"
        },
        {
            "id": 658,
            "name": "Gareth"
        },
        {
            "id": 442,
            "name": "Head Clown Nurse"
        },
        {
            "id": 1069,
            "name": "Lord Vandalstine"
        },
        {
            "id": 227,
            "name": "Muscle Princess"
        },
        {
            "id": 1097,
            "name": "Phlannel Boxingday"
        }
    ]
}
            
        
Field Type Description
id int Id given to this species within the API's database
species str Name of species
created str UTC time in which this species was created in the database
modified str UTC time in which this species was modified in the database
characters array List of characters that are a member of this species

Occupations

Occupations may refer to a character's current or previous occupation.

Sample Request

GET http://adventuretimeapi.com/api/v1/occupations/1/

            
{
    "id": 1,
    "title": "Princess",
    "created": "2015-07-20T07:02:43.616892Z",
    "modified": "2015-07-20T07:02:43.616910Z",
    "characters": [
        {
            "id": 3,
            "name": "Lumpy Space Princess"
        },
        {
            "id": 136,
            "name": "Old Lady Princess"
        },
        {
            "id": 229,
            "name": "Peanut Princess"
        },
        {
            "id": 233,
            "name": "Space Angel Princess"
        },
        {
            "id": 374,
            "name": "Breakfast Princess"
        },
        {
            "id": 453,
            "name": "Flame Princess"
        },
        {
            "id": 489,
            "name": "Elbow Princess"
        },
        {
            "id": 769,
            "name": "Strudel Princess"
        },
        {
            "id": 851,
            "name": "Acoustics Princess"
        },
        {
            "id": 854,
            "name": "Agent Princess"
        },
        {
            "id": 224,
            "name": "Bee Princess"
        },
        {
            "id": 625,
            "name": "Bounce House Princess"
        },
        {
            "id": 876,
            "name": "Bruise Princess"
        },
        {
            "id": 916,
            "name": "Cotton Candy Princess"
        },
        {
            "id": 750,
            "name": "Crab Princess"
        },
        {
            "id": 923,
            "name": "Desert Princess"
        },
        {
            "id": 232,
            "name": "Skeleton Princess"
        },
        {
            "id": 58,
            "name": "Slime Princess"
        },
        {
            "id": 375,
            "name": "Toast Princess"
        },
        {
            "id": 964,
            "name": "Truth Field Projection Princess"
        },
        {
            "id": 973,
            "name": "Water Princess"
        },
        {
            "id": 57,
            "name": "Wildberry Princess"
        },
        {
            "id": 82,
            "name": "Engagement Ring Princess"
        },
        {
            "id": 225,
            "name": "Embryo Princess"
        },
        {
            "id": 83,
            "name": "Emerald Princess"
        },
        {
            "id": 751,
            "name": "Frozen Yogurt Princess"
        },
        {
            "id": 1028,
            "name": "Ghost Princess 2"
        },
        {
            "id": 1029,
            "name": "Ghost Princess (character)"
        },
        {
            "id": 228,
            "name": "Gridface Princess"
        },
        {
            "id": 694,
            "name": "Blargetha"
        },
        {
            "id": 5,
            "name": "Hot Dog Princess"
        },
        {
            "id": 226,
            "name": "Jungle Princess"
        },
        {
            "id": 1065,
            "name": "Lamprey Princess"
        },
        {
            "id": 1066,
            "name": "Laurel Princess"
        },
        {
            "id": 749,
            "name": "Lizard Princess"
        },
        {
            "id": 1090,
            "name": "Painting Princess"
        },
        {
            "id": 301,
            "name": "Princess Beautiful"
        },
        {
            "id": 1105,
            "name": "Princess Chewypaste"
        },
        {
            "id": 230,
            "name": "Princess Princess Princess"
        },
        {
            "id": 231,
            "name": "Purple Princess"
        }
    ]
}
            
        
Field Type Description
id int Id given to this occupation within this API's database
title str Title of occupation
created str UTC time in which this occupation was created in the database
modified str UTC time in which this occupation was modified in the database
characters array List of characters that have this occupation

Episodes

Episode information!!!

Sample Request

GET http://adventuretimeapi.com/api/v1/episodes/7/

            
{
    "id": 7,
    "title": "Ricardio the Heart Guy",
    "season_id": 1,
    "episode_id": 7,
    "link": "http://adventuretime.wikia.com/wiki/Ricardio_the_Heart_Guy",
    "title_card": "http://img4.wikia.nocookie.net/__cb20120211102505/adventuretimewithfinnandjake/images/b/b6/Titlecard_S1E7_ricardiotheheartguy.jpg",
    "description": "After saving Princess Bubblegum from the Ice King yet again she offers them a party, but during the party Finn grows jealous of a suspicious heart-shaped man that is wooing with Princesss Bubblegum and sets out to prove that he's evil.",
    "production_code": "692-007",
    "air_date": "April 26, 2010",
    "air_date_utc": "2010-04-26",
    "viewers": "1.91",
    "created": "2015-07-20T07:01:41.406890Z",
    "modified": "2015-07-20T07:02:02.517749Z",
    "characters": [
        {
            "id": 1,
            "name": "Finn"
        },
        {
            "id": 2,
            "name": "Jake"
        },
        {
            "id": 4,
            "name": "Princess Bubblegum"
        },
        {
            "id": 65,
            "name": "Ice King"
        },
        {
            "id": 79,
            "name": "Ricardio"
        },
        {
            "id": 17,
            "name": "Candy People"
        },
        {
            "id": 80,
            "name": "Banana Guard"
        },
        {
            "id": 24,
            "name": "Pineapple Guy"
        },
        {
            "id": 81,
            "name": "Candy Magician"
        },
        {
            "id": 25,
            "name": "Banana Guy"
        },
        {
            "id": 18,
            "name": "Starchie"
        },
        {
            "id": 33,
            "name": "Lollipop Girl"
        },
        {
            "id": 23,
            "name": "Mr. Cupcake"
        },
        {
            "id": 35,
            "name": "Chocolate Bar Guy"
        },
        {
            "id": 36,
            "name": "Gingerbread Pen"
        },
        {
            "id": 37,
            "name": "Gingerbread Pat"
        },
        {
            "id": 38,
            "name": "Gingerbread Muto"
        },
        {
            "id": 40,
            "name": "Gumball Guardian"
        },
        {
            "id": 3,
            "name": "Lumpy Space Princess"
        },
        {
            "id": 5,
            "name": "Hot Dog Princess"
        },
        {
            "id": 57,
            "name": "Wildberry Princess"
        },
        {
            "id": 82,
            "name": "Engagement Ring Princess"
        },
        {
            "id": 83,
            "name": "Emerald Princess"
        },
        {
            "id": 31,
            "name": "Peppermint Butler"
        },
        {
            "id": 58,
            "name": "Slime Princess"
        },
        {
            "id": 14,
            "name": "Snail"
        },
        {
            "id": 151,
            "name": "Balloons"
        },
        {
            "id": 894,
            "name": "Candy Person 39"
        },
        {
            "id": 797,
            "name": "Starchy"
        },
        {
            "id": 534,
            "name": "Zanoits"
        },
        {
            "id": 1100,
            "name": "Plantoids"
        }
    ]
}
            
        
Field Type Description
id int Id given to this episode within this API's database
title str Title of episode
season_id int Season ID which this episode belongs to
episode_id int Episode ID within it's season
link str Link to episode information on adventuretime.wikia.com
title_card str Link to image of the episode's title card (Note: Dimensions will vary)
description str Short description of the episode
production_code str Production code
air_date str Air date
air_date_utc str Air date in UTC format
viewers str Viewer by millions. Some episode's information may not have been announced yet.
created str UTC time in which this episode was created in the database
modified str UTC time in which this episode was last updated in the database
characters array List of character's major appearances in this episode

Additional Query Parameters

Attaching additional query parameters to your API call is very simple. You need only attach /?{query parameter}={value} to the end of your url. To use several query parameters together, add the next query parameter to your first query parameter your url, but use /& instead of /?.

Resource Search Query Field
search search={query}
page_size page_size={number}
page page={number}
season_id season_id={number} Works only for the episodes resource. Get specific episodes using this in conjunction with the episode_id parameter.
episode_id episode_id={number} Works only for the episodes resource.

Each resource has the ability for the optional search parameter by attaching /?search={query} to the end of a resource instead of /{id}.

Sample Request

GET http://adventuretimeapi.com/api/v1/characters/?search=abraham

            
{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 66,
            "name": "Abraham Lincoln",
            "full_name": "Abraham Lincoln",
            "sex": "Male",
            "link": "http://adventuretime.wikia.com/wiki/Abe_Lincoln",
            "image": "http://img3.wikia.nocookie.net/__cb20120725234200/adventuretimewithfinnandjake/images/a/a4/Abraham_Lincoln.png",
            "created": "2015-07-20T07:01:41.297801Z",
            "modified": "2015-07-20T07:02:43.774303Z",
            "episode": [
                {
                    "id": 5,
                    "title": "Animated short"
                },
                {
                    "id": 9,
                    "title": "Business Time"
                },
                {
                    "id": 34,
                    "title": "Crystals Have Power"
                },
                {
                    "id": 79,
                    "title": "Return to the Nightosphere"
                },
                {
                    "id": 93,
                    "title": "Sons of Mars"
                },
                {
                    "id": 119,
                    "title": "A Glitch is a Glitch"
                },
                {
                    "id": 140,
                    "title": "Box Prince"
                },
                {
                    "id": 194,
                    "title": "Orgalorg"
                }
            ],
            "species": [
                {
                    "id": 3,
                    "name": "Human"
                }
            ],
            "relatives_many": [],
            "occupations": [
                {
                    "id": 4,
                    "title": "Former King of Mars,"
                },
                {
                    "id": 5,
                    "title": "Former President of the United States"
                }
            ]
        }
    ]
}
            
        
Resource Search Query Field
characters name, full_name
species name
occupations title
episodes title