Rick and Morty
App · Film, TV & Fandom · 8 actions
Look up characters, locations and episodes from the Rick and Morty TV show with the free, keyless Rick and Morty API. It covers seasons 1 to 5 only: 51 episodes, ending with S05E10, as the API's data has not been updated since season 5 ended in 2021. No account or API key required. Disclaimer: this is an independent integration with the community-run Rick and Morty API (rickandmortyapi.com). It is not affiliated with, endorsed by, or sponsored by Adult Swim, Cartoon Network, Warner Bros. Discovery, or the creators of Rick and Morty; all related names and trademarks belong to their respective owners.
Actions
| Action | What it does |
|---|---|
| Get a character | Get one Rick and Morty character by its id or its link. |
| Get a location | Get one Rick and Morty location by its id or its link, with links to the characters last seen there. |
| Get an episode | Get one Rick and Morty episode by its id or its link, with links to every character in it. |
| Get several characters | Get several Rick and Morty characters in one step, by id or link. |
| Get several episodes | Get several Rick and Morty episodes in one step, by id or link. |
| List characters | List Rick and Morty characters, 20 to a page, optionally filtered by name, status, species, type or gender. |
| List episodes | List Rick and Morty episodes, 20 to a page, optionally filtered by name or episode code. |
| List locations | List Rick and Morty locations, 20 to a page, optionally filtered by name, type or dimension. |
Get a character
Get one Rick and Morty character by its id or its link. No API key required.
Inputs
- Character ID
character_idnumberRequired - The character's id, a whole number such as 2 for Morty Smith, or its link from another step, such as https://rickandmortyapi.com/api/character/2.At least 1.
Outputs
characterobject- One character, and everything the API records about it.
Example output
{
"character": {
"created": "2017-11-04T18:50:21.651Z",
"episode": [
"https://rickandmortyapi.com/api/episode/1",
"https://rickandmortyapi.com/api/episode/2"
],
"gender": "Male",
"id": 2,
"image": "https://rickandmortyapi.com/api/character/avatar/2.jpeg",
"location": {
"name": "Citadel of Ricks",
"url": "https://rickandmortyapi.com/api/location/3"
},
"name": "Morty Smith",
"origin": {
"name": "unknown",
"url": ""
},
"species": "Human",
"status": "Alive",
"type": "",
"url": "https://rickandmortyapi.com/api/character/2"
}
}Get a location
Get one Rick and Morty location by its id or its link, with links to the characters last seen there. No API key required.
Inputs
- Location ID
location_idnumberRequired - The location's id, a whole number such as 3 for the Citadel of Ricks, or its link from another step, such as https://rickandmortyapi.com/api/location/3.At least 1.
Outputs
locationobject- One location, and everything the API records about it.
Example output
{
"location": {
"created": "2017-11-10T13:08:13.191Z",
"dimension": "unknown",
"id": 3,
"name": "Citadel of Ricks",
"residents": [
"https://rickandmortyapi.com/api/character/8",
"https://rickandmortyapi.com/api/character/14"
],
"type": "Space station",
"url": "https://rickandmortyapi.com/api/location/3"
}
}Get an episode
Get one Rick and Morty episode by its id or its link, with links to every character in it. The API covers seasons 1 to 5 only, episode ids 1 to 51. No API key required.
Inputs
- Episode ID
episode_idnumberRequired - The episode's id, a whole number from 1 to 51 such as 28 for The Ricklantis Mixup, or its link from another step, such as https://rickandmortyapi.com/api/episode/28.At least 1.
Outputs
episodeobject- One episode, and everything the API records about it.
Example output
{
"episode": {
"air_date": "September 10, 2017",
"characters": [
"https://rickandmortyapi.com/api/character/1",
"https://rickandmortyapi.com/api/character/2"
],
"created": "2017-11-10T12:56:36.618Z",
"episode": "S03E07",
"id": 28,
"name": "The Ricklantis Mixup",
"url": "https://rickandmortyapi.com/api/episode/28"
}
}Get several characters
Get several Rick and Morty characters in one step, by id or link. Pass an episode's characters or a location's residents to turn their links into full characters. They come back in id order, and an id the API does not have is left out and listed in missing_ids. No API key required.
Inputs
- Character IDs
character_idslistRequired - The characters to get: their ids or links, as a list or as text separated by commas. An episode's characters or a location's residents can go in as they are. Repeats and empty links are skipped. Up to 1,000.
Outputs
characterslist- The characters found, in id order, each once.
countnumber- How many characters were found.
missing_idslist- The ids asked for that the API does not have, in the order they were given. Empty when every one was found.
Example output
{
"characters": [
{
"created": "2017-11-04T18:48:46.250Z",
"episode": [
"https://rickandmortyapi.com/api/episode/1",
"https://rickandmortyapi.com/api/episode/2"
],
"gender": "Male",
"id": 1,
"image": "https://rickandmortyapi.com/api/character/avatar/1.jpeg",
"location": {
"name": "Citadel of Ricks",
"url": "https://rickandmortyapi.com/api/location/3"
},
"name": "Rick Sanchez",
"origin": {
"name": "Earth (C-137)",
"url": "https://rickandmortyapi.com/api/location/1"
},
"species": "Human",
"status": "Alive",
"type": "",
"url": "https://rickandmortyapi.com/api/character/1"
},
{
"created": "2017-11-04T18:50:21.651Z",
"episode": [
"https://rickandmortyapi.com/api/episode/1",
"https://rickandmortyapi.com/api/episode/2"
],
"gender": "Male",
"id": 2,
"image": "https://rickandmortyapi.com/api/character/avatar/2.jpeg",
"location": {
"name": "Citadel of Ricks",
"url": "https://rickandmortyapi.com/api/location/3"
},
"name": "Morty Smith",
"origin": {
"name": "unknown",
"url": ""
},
"species": "Human",
"status": "Alive",
"type": "",
"url": "https://rickandmortyapi.com/api/character/2"
}
],
"count": 2,
"missing_ids": []
}Get several episodes
Get several Rick and Morty episodes in one step, by id or link. Pass a character's episode list to get every episode it appears in. They come back in id order, and an id the API does not have is left out and listed in missing_ids. The API covers seasons 1 to 5 only. No API key required.
Inputs
- Episode IDs
episode_idslistRequired - The episodes to get: their ids or links, as a list or as text separated by commas. A character's episode list can go in as it is. Repeats and empty links are skipped. Up to 1,000.
Outputs
countnumber- How many episodes were found.
episodeslist- The episodes found, in id order (the order they aired), each once.
missing_idslist- The ids asked for that the API does not have, in the order they were given. Empty when every one was found.
Example output
{
"count": 2,
"episodes": [
{
"air_date": "December 2, 2013",
"characters": [
"https://rickandmortyapi.com/api/character/1",
"https://rickandmortyapi.com/api/character/2"
],
"created": "2017-11-10T12:56:33.798Z",
"episode": "S01E01",
"id": 1,
"name": "Pilot",
"url": "https://rickandmortyapi.com/api/episode/1"
},
{
"air_date": "December 9, 2013",
"characters": [
"https://rickandmortyapi.com/api/character/1",
"https://rickandmortyapi.com/api/character/2"
],
"created": "2017-11-10T12:56:33.916Z",
"episode": "S01E02",
"id": 2,
"name": "Lawnmower Dog",
"url": "https://rickandmortyapi.com/api/episode/2"
}
],
"missing_ids": []
}List characters
List Rick and Morty characters, 20 to a page, optionally filtered by name, status, species, type or gender. The text filters match any part of the value and ignore case. No API key required.
Inputs
- Name
nametext - Only characters whose name contains this, in any case (for example, rick finds Rick Sanchez and Adjudicator Rick).
- Status
statustext - Only characters with this life status.One of:
alive,dead,unknown. - Species
speciestext - Only characters whose species contains this, in any case (for example, human, which also finds Humanoid).
- Type
typetext - Only characters whose type or subspecies contains this, in any case (for example, parasite).
- Gender
gendertext - Only characters of this gender.One of:
female,male,genderless,unknown. - Page
pagenumber - Which page of 20 to return, starting at 1. Leave empty for the first page. A page past the last one returns no results, but still gives the real count and number of pages.At least 1.
Outputs
charactersobject- One page of the characters that match, with how many match in all.
Example output
{
"characters": {
"info": {
"count": 826,
"next": "https://rickandmortyapi.com/api/character?page=2",
"pages": 42,
"prev": null
},
"results": [
{
"created": "2017-11-04T18:48:46.250Z",
"episode": [
"https://rickandmortyapi.com/api/episode/1",
"https://rickandmortyapi.com/api/episode/2"
],
"gender": "Male",
"id": 1,
"image": "https://rickandmortyapi.com/api/character/avatar/1.jpeg",
"location": {
"name": "Citadel of Ricks",
"url": "https://rickandmortyapi.com/api/location/3"
},
"name": "Rick Sanchez",
"origin": {
"name": "Earth (C-137)",
"url": "https://rickandmortyapi.com/api/location/1"
},
"species": "Human",
"status": "Alive",
"type": "",
"url": "https://rickandmortyapi.com/api/character/1"
}
]
}
}List episodes
List Rick and Morty episodes, 20 to a page, optionally filtered by name or episode code. The filters match any part of the value and ignore case. The API covers seasons 1 to 5 only: 51 episodes, ending with S05E10. No API key required.
Inputs
- Name
nametext - Only episodes whose title contains this, in any case (for example, pilot).
- Episode
episodetext - Only episodes whose code contains this, in any case: S01E01 for one episode, or S03 for a whole season. Seasons 1 to 5 only.
- Page
pagenumber - Which page of 20 to return, starting at 1. Leave empty for the first page. A page past the last one returns no results, but still gives the real count and number of pages.At least 1.
Outputs
episodesobject- One page of the episodes that match, with how many match in all.
Example output
{
"episodes": {
"info": {
"count": 51,
"next": "https://rickandmortyapi.com/api/episode?page=2",
"pages": 3,
"prev": null
},
"results": [
{
"air_date": "December 2, 2013",
"characters": [
"https://rickandmortyapi.com/api/character/1",
"https://rickandmortyapi.com/api/character/2"
],
"created": "2017-11-10T12:56:33.798Z",
"episode": "S01E01",
"id": 1,
"name": "Pilot",
"url": "https://rickandmortyapi.com/api/episode/1"
}
]
}
}List locations
List Rick and Morty locations, 20 to a page, optionally filtered by name, type or dimension. The filters match any part of the value and ignore case. No API key required.
Inputs
- Name
nametext - Only locations whose name contains this, in any case (for example, earth finds Earth (C-137) and Cronenberg Earth).
- Type
typetext - Only locations whose type contains this, in any case (for example, planet or space station).
- Dimension
dimensiontext - Only locations whose dimension contains this, in any case (for example, C-137 finds Dimension C-137).
- Page
pagenumber - Which page of 20 to return, starting at 1. Leave empty for the first page. A page past the last one returns no results, but still gives the real count and number of pages.At least 1.
Outputs
locationsobject- One page of the locations that match, with how many match in all.
Example output
{
"locations": {
"info": {
"count": 126,
"next": "https://rickandmortyapi.com/api/location?page=2",
"pages": 7,
"prev": null
},
"results": [
{
"created": "2017-11-10T12:42:04.162Z",
"dimension": "Dimension C-137",
"id": 1,
"name": "Earth (C-137)",
"residents": [
"https://rickandmortyapi.com/api/character/38",
"https://rickandmortyapi.com/api/character/45"
],
"type": "Planet",
"url": "https://rickandmortyapi.com/api/location/1"
}
]
}
}