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

ActionWhat it does
Get a characterGet one Rick and Morty character by its id or its link.
Get a locationGet one Rick and Morty location by its id or its link, with links to the characters last seen there.
Get an episodeGet one Rick and Morty episode by its id or its link, with links to every character in it.
Get several charactersGet several Rick and Morty characters in one step, by id or link.
Get several episodesGet several Rick and Morty episodes in one step, by id or link.
List charactersList Rick and Morty characters, 20 to a page, optionally filtered by name, status, species, type or gender.
List episodesList Rick and Morty episodes, 20 to a page, optionally filtered by name or episode code.
List locationsList 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 IDcharacter_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 IDlocation_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 IDepisode_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 IDscharacter_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 IDsepisode_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

Namenametext
Only characters whose name contains this, in any case (for example, rick finds Rick Sanchez and Adjudicator Rick).
Statusstatustext
Only characters with this life status.One of: alive, dead, unknown.
Speciesspeciestext
Only characters whose species contains this, in any case (for example, human, which also finds Humanoid).
Typetypetext
Only characters whose type or subspecies contains this, in any case (for example, parasite).
Gendergendertext
Only characters of this gender.One of: female, male, genderless, unknown.
Pagepagenumber
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

Namenametext
Only episodes whose title contains this, in any case (for example, pilot).
Episodeepisodetext
Only episodes whose code contains this, in any case: S01E01 for one episode, or S03 for a whole season. Seasons 1 to 5 only.
Pagepagenumber
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

Namenametext
Only locations whose name contains this, in any case (for example, earth finds Earth (C-137) and Cronenberg Earth).
Typetypetext
Only locations whose type contains this, in any case (for example, planet or space station).
Dimensiondimensiontext
Only locations whose dimension contains this, in any case (for example, C-137 finds Dimension C-137).
Pagepagenumber
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"
      }
    ]
  }
}

On this page