Welcome to the Prisoner API. This documentation should provide you with all the information you need to start making your HTTP requests. This API is free. Feel free to use it in your projects.
Although this API is free, there is a rate limit of 10,000 requests a day to prevent malicious activity. That means that if you happen to reach that limit, you will receive a 429 status code, after which you will be able to make requests again after 24 hours.
https://the-prisoner-api.vercel.app/| Attribute | Type | Description |
|---|---|---|
| id | integer | Unique id per episode |
| title | string | Episode title |
| episode | string | Episode number |
| directed_by | string | Episode director |
| written_by | array | Episode writer(s) |
| air_year | string | Original year episode aired |
| air_date | string | Original air date |
| wikipedia_storyline | string | Brief overview of episode from Wikipedia |
| imdb_storyline | string | Brief overview of episode from IMDb |
| cast | string | Episode actor |
| guest_appearances | array | Episode guest actor(s) |
| title_img | string | Title image from episode |
| img | string | Image from episode |
| wikipedia | string | Link to episode Wikipedia page |
| imdb | string | Link to episode IMDb page |
| trivia | string | Trivia from episode |
Endpoint to retrieve information from all episodes.
/episodesThe request for all of the episodes looks like this.
fetch('https://the-prisoner-api.vercel.app/episodes')
.then(response => response.json())
.then(json => console.log(json))
Example request by episode id. In this example, episode with an id of 1 is being requested.
fetch('https://the-prisoner-api.vercel.app/episodes/1')
.then(response => response.json())
.then(json => console.log(json))
Running this script will return the following data.
{
"id": 1,
"title": "Arrival",
"episode": "1",
"directed_by": "Don Chaffey",
"written_by": [
"George Markstein",
"David Tomblin"
],
"air_year": "1967",
"air_date": "09-29-1967",
"wikipedia_storyline": "After waking up in the Village and discovering his captivity there, Number Six encounters a friend from the outside who may have a possible escape.",
"imdb_storyline": "After resigning, a secret agent finds himself trapped in a bizarre prison known only as The Village.",
"cast": "Patrick McGoohan",
"guest_appearances": [
"Guy Doleman",
"George Baker",
"Virginia Maskell",
"Paul Eddington"
],
"title_img": "https://i.postimg.cc/6544t2SP/01-arrival-title.png",
"img": "https://i.postimg.cc/9050f1sN/01-arrival.png",
"wikipedia": "https://en.wikipedia.org/wiki/Arrival_(The_Prisoner)",
"imdb": "https://www.imdb.com/title/tt0679174/",
"trivia": "No 6 gives his birthdate and time as 4.31 am, 19th March, 1928 - which is exactly the same as Patrick McGoohan's."
}