Documentation

This API is GET only and no authentication is required to access it.

REST

Base url: https://api.disneyapi.dev

Available endpoints:

{
  filterCharacter: 'https://api.disneyapi.dev/character?queryParams',
  getAllCharacters: 'https://api.disneyapi.dev/character',
  getOneCharacter: 'https://api.disneyapi.dev/character/:id'
}

Get all characters

Get the list of all characters using the /character endpoint.

https://api.disneyapi.dev/character
{
  "info": {
    "totalPages": 149,
    "count": 50,
    "previousPage": "https://api.disneyapi.dev/character?page=3",
    "nextPage": "https://api.disneyapi.dev/character?page=5",
  },
  "data": [
    {
      "_id":308,
      "films":["Tangled","Tangled: Before Ever After"],
      "shortFilms":["Tangled Ever After","Hare Peace"],
      "tvShows":["Once Upon a Time","Tangled: The Series"],
      "videoGames":["Disney Princess Enchanting Storybooks","Hidden Worlds","Disney Crossy Road","Kingdom Hearts III"],
      "parkAttractions":["Celebrate the Magic","Jingle Bell, Jingle BAM!"],
      "allies":[],
      "enemies":[],
      "sourceUrl":"https://disney.fandom.com/wiki/Queen_Arianna",
      "name":"Queen Arianna",
      "imageUrl":"https://static.wikia.nocookie.net/disney/images/1/15/Arianna_Tangled.jpg/revision/latest?cb=20160715191802",
      "createdAt":"2021-04-12T01:33:34.458Z",
      "updatedAt":"2021-04-12T01:33:34.458Z",
      "url":"https://api.disneyapi.dev/characters/308",
      "__v":0
    }
    ...
  ],
}

Query params available:

  • page: The page number to get. Default: 1
  • pageSize: The number of items per page. Default: 50

Get one character

Get the details about one character using the character/:id endpoint.

https://api.disneyapi.dev/character/308
{
  "info": {
    "count": 1
  },
  "data": {
    "_id": 308,
    "films": ["Tangled", "Tangled: Before Ever After"],
    "shortFilms": ["Tangled Ever After", "Hare Peace"],
    "tvShows": ["Once Upon a Time", "Tangled: The Series"],
    "videoGames": [
      "Disney Princess Enchanting Storybooks",
      "Hidden Worlds",
      "Disney Crossy Road",
      "Kingdom Hearts III"
    ],
    "parkAttractions": ["Celebrate the Magic", "Jingle Bell, Jingle BAM!"],
    "allies": [],
    "enemies": [],
    "name": "Queen Arianna",
    "imageUrl": "https://static.wikia.nocookie.net/disney/images/1/15/Arianna_Tangled.jpg",
    "url": "https://api.disneyapi.dev/characters/308"
  }
}

Filter characters

Filter a specific character using the character?params endpoint.

https://api.disneyapi.dev/character?name=Mickey%20Mouse
{
    "info": {
      "count": 1
    },
    "data": [
      {
        "_id": 4703,
        "films": [...],
        "shortFilms": [...],
        "tvShows": [...],
        "videoGames": [...],
        "parkAttractions": [...],
        "allies": [...],
        "enemies": [...],
        "name": "Mickey Mouse",
        "imageUrl": "https://static.wikia.nocookie.net/disney/images/9/99/Mickey_Mouse_Disney_3.jpeg",
        "url": "https://api.disneyapi.dev/characters/4703",
      }
    ],
}

GraphQL

Base url: https://api.disneyapi.dev/graphql

Available queries:

characters(
  page: Int,
  pagSize: Int,
  filter: CharacterFilterInput,
) {
  items: [Character]
  paginationInfo: {
    hasPreviousPage: Boolean!
    hasNextPage: Boolean!
    pageItemCount: Int!
    totalPages: Int!
  }
}

input CharacterFilterInput {
  id: Int
  name: String
  films: String
  shortFilms: String
  tvShows: String
  videoGames: String
  alignment: String
  parkAttractions: String
  allies: String
  enemies: String
}

Schemas

Character

There's a total of 7438 characters available

| Key | Type | | --------------- | -------- | | _id | Integer | | url | String | | name | String | | sourceUrl | String | | films | [String] | | shortFilms | [String] | | tvShows | [String] | | videoGames | [String] | | alignment | String | | parkAttractions | [String] | | allies | [String] | | enemies | [String] |