The Stephen King API is a free, open-source REST API providing data about Stephen King's novels, short stories, the collections they were published in, the magazines and anthologies they first appeared in, villains, places, and the types of villain. No authentication is required. All endpoints are read-only (GET requests only).
Responses are returned in JSON format. Related resources include links to their associated endpoints for easy traversal.
https://stephen-king-api.onrender.com/api
All endpoints described below are relative to this base URL.
All list endpoints support optional pagination via query parameters:
| Parameter | Type | Description |
|---|---|---|
page |
integer | Page number (starts at 1) |
limit |
integer | Items per page (max 100) |
Both page and limit must be provided together to enable pagination. Without them, all results are returned. Values that aren't whole numbers return a 400 error.
GET https://stephen-king-api.onrender.com/api/books
{
"data": [ ... ]
}
GET https://stephen-king-api.onrender.com/api/books?page=1&limit=5
{
"data": [ ... ],
"pagination": {
"page": 1,
"limit": 5,
"total": 68,
"totalPages": 14
}
}
Errors are returned as JSON with an HTTP status code and an error message:
{
"error": "Villain not found"
}
| Status | Meaning |
|---|---|
400 |
An id, page or limit isn't a whole number |
404 |
No record with that id, or no such endpoint |
429 |
Too many requests (see Rate Limits) |
500 |
Something went wrong on the server. The body has a message field instead of error. |
Each IP address can make 100 requests per minute. Every response reports where you stand in the RateLimit and RateLimit-Policy headers:
RateLimit-Policy: 100;w=60 RateLimit: limit=100, remaining=99, reset=60
reset is the number of seconds until the count starts over. Past the limit, requests return 429 with a Retry-After header until the minute is up. To get everything at once, call a list endpoint without page and limit: one request returns the whole collection.
Returns all books. Supports pagination.
GET https://stephen-king-api.onrender.com/api/books?page=2&limit=1
{
"data": [
{
"id": 2,
"Year": 1975,
"Title": "Salem's Lot",
"handle": "salem-s-lot",
"Publisher": "Doubleday",
"ISBN": "978-0-385-00751-1",
"Pages": 439,
"Notes": [
"Nominee, World Fantasy Award, 1976[2]"
],
"created_at": "2023-11-13T23:48:48.098Z",
"villains": [
{
"name": "Kurt Barlow",
"url": "https://stephen-king-api.onrender.com/api/villain/2"
},
{
"name": "Richard Straker",
"url": "https://stephen-king-api.onrender.com/api/villain/98"
}
],
"places": [
{
"name": "Todash Space",
"url": "https://stephen-king-api.onrender.com/api/place/6"
},
{
"name": "Maine",
"url": "https://stephen-king-api.onrender.com/api/place/28"
},
{
"name": "Jerusalem's Lot, Maine",
"url": "https://stephen-king-api.onrender.com/api/place/76"
},
{
"name": "Portland, Maine",
"url": "https://stephen-king-api.onrender.com/api/place/95"
},
{
"name": "Cumberland Consolidated High School",
"url": "https://stephen-king-api.onrender.com/api/place/129"
},
{
"name": "Harmony Hill Cemetery",
"url": "https://stephen-king-api.onrender.com/api/place/145"
},
{
"name": "Brock Street School",
"url": "https://stephen-king-api.onrender.com/api/place/157"
},
{
"name": "Jerusalem's Lot Public Library",
"url": "https://stephen-king-api.onrender.com/api/place/169"
},
{
"name": "Marsten House",
"url": "https://stephen-king-api.onrender.com/api/place/170"
},
{
"name": "Stanley Street Elementary School",
"url": "https://stephen-king-api.onrender.com/api/place/173"
}
],
"collection": null
}
],
"pagination": {
"page": 2,
"limit": 1,
"total": 68,
"totalPages": 68
}
}
Returns a single book by ID.
GET https://stephen-king-api.onrender.com/api/book/3
{
"data": {
"id": 3,
"Year": 1977,
"Title": "The Shining",
"handle": "the-shining",
"Publisher": "Doubleday",
"ISBN": "978-0-385-12167-5",
"Pages": 447,
"Notes": [
"Runner-up (4th place), Locus Award for Best Fantasy Novel, 1978[2]"
],
"created_at": "2023-11-13T23:48:48.219Z",
"villains": [
{
"name": "Horace M. Derwent",
"url": "https://stephen-king-api.onrender.com/api/villain/26"
},
{
"name": "Delbert Grady",
"url": "https://stephen-king-api.onrender.com/api/villain/45"
},
{
"name": "Jack Torrance",
"url": "https://stephen-king-api.onrender.com/api/villain/106"
},
{
"name": "Roger the Dog Man",
"url": "https://stephen-king-api.onrender.com/api/villain/162"
}
],
"places": [
{
"name": "Boulder, Colorado",
"url": "https://stephen-king-api.onrender.com/api/place/50"
},
{
"name": "Sidewinder, Colorado",
"url": "https://stephen-king-api.onrender.com/api/place/106"
},
{
"name": "Stovington, Vermont",
"url": "https://stephen-king-api.onrender.com/api/place/108"
},
{
"name": "Overlook Hotel",
"url": "https://stephen-king-api.onrender.com/api/place/133"
},
{
"name": "Room 237",
"url": "https://stephen-king-api.onrender.com/api/place/172"
}
],
"collection": null
}
}
Returns all short stories. Supports pagination.
GET https://stephen-king-api.onrender.com/api/shorts?page=1&limit=1
{
"data": [
{
"id": 1,
"title": "Land of 1,000,000 Years Ago",
"type": "short story",
"handle": "land-of-1-000-000-years-ago",
"originallyPublishedIn": "",
"publication": null,
"collectedIn": "Uncollected",
"collection": null,
"notes": [
"Self-published"
],
"year": 1959,
"created_at": "2023-11-13T23:48:55.954Z",
"villains": [],
"places": []
}
],
"pagination": {
"page": 1,
"limit": 1,
"total": 222,
"totalPages": 222
}
}
Returns a single short story by ID.
GET https://stephen-king-api.onrender.com/api/short/114
{
"data": {
"id": 114,
"title": "The Langoliers",
"type": "novella",
"handle": "the-langoliers",
"originallyPublishedIn": "Four Past Midnight (September 1990)",
"publication": null,
"collectedIn": "Four Past Midnight (1990)",
"collection": {
"name": "Four Past Midnight",
"url": "https://stephen-king-api.onrender.com/api/collection/5"
},
"notes": [
"Nominee, Bram Stoker Award, 1991[2]"
],
"year": 1990,
"created_at": "2023-11-13T23:49:10.278Z",
"villains": [
{
"name": "Craig Toomey",
"url": "https://stephen-king-api.onrender.com/api/villain/105"
},
{
"name": "Langoliers",
"url": "https://stephen-king-api.onrender.com/api/villain/147"
}
],
"places": []
}
}
Villain responses include books and shorts arrays (instead of a villains array) linking to the works they appear in, a residence array linking to where they live, and their type and kinds. A group villain is a set of villains, such as a gang, a cult or a race.
Returns all villains. Supports pagination.
GET https://stephen-king-api.onrender.com/api/villains?page=1&limit=1
{
"data": [
{
"id": 1,
"name": "Bob Anderson",
"gender": "Male",
"status": "Deceased",
"types_id": 1,
"group": false,
"notes": [
"Stubs",
"Characters",
"Pownal residents",
"Yarmouth residents",
"Residents of Maine",
"Villains",
"Crime"
],
"created_at": "2023-11-13T23:49:22.390Z",
"books": [],
"shorts": [
{
"title": "A Good Marriage",
"url": "https://stephen-king-api.onrender.com/api/short/180"
}
],
"residence": [
{
"name": "Pownal, Maine",
"url": "https://stephen-king-api.onrender.com/api/place/96"
},
{
"name": "Yarmouth, Maine",
"url": "https://stephen-king-api.onrender.com/api/place/119"
}
],
"type": {
"name": "Human",
"url": "https://stephen-king-api.onrender.com/api/type/1"
},
"kinds": []
}
],
"pagination": {
"page": 1,
"limit": 1,
"total": 201,
"totalPages": 201
}
}
Returns a single villain by ID.
GET https://stephen-king-api.onrender.com/api/villain/2
{
"data": {
"id": 2,
"name": "Kurt Barlow",
"gender": "Male",
"status": "Deceased",
"types_id": 2,
"group": false,
"notes": [
"Characters",
"Jerusalem's Lot residents",
"Residents of Maine",
"Villains",
"Antagonists"
],
"created_at": "2023-11-13T23:49:22.625Z",
"books": [
{
"title": "Salem's Lot",
"url": "https://stephen-king-api.onrender.com/api/book/2"
}
],
"shorts": [],
"residence": [
{
"name": "Marsten House",
"url": "https://stephen-king-api.onrender.com/api/place/170"
}
],
"type": {
"name": "Vampire",
"url": "https://stephen-king-api.onrender.com/api/type/2"
},
"kinds": [
{
"name": "Type One vampire",
"url": "https://stephen-king-api.onrender.com/api/type/11"
}
]
}
}
Places run from buildings up to towns, states, countries and other worlds. Each place links to its parent, the place it's in, and lists the places inside it, so Marsten House leads to Jerusalem's Lot, then Maine, then the United States. A place also links to the books and shorts set there and the villains who live there, counting anyone living in a place inside it: Kurt Barlow lives in the Marsten House, so Jerusalem's Lot and Maine list him too. Books, shorts and villains link back: a book lists its places, and a villain lists its residence.
Returns all places, broadest first. Supports pagination.
GET https://stephen-king-api.onrender.com/api/places?page=1&limit=1
{
"data": [
{
"id": 1,
"name": "All-world",
"handle": "all-world",
"type": "world",
"created_at": "2026-10-28T20:25:46.000Z",
"parent": null,
"places": [
{
"name": "End-world",
"url": "https://stephen-king-api.onrender.com/api/place/16"
},
{
"name": "In-world",
"url": "https://stephen-king-api.onrender.com/api/place/17"
},
{
"name": "Mid-world",
"url": "https://stephen-king-api.onrender.com/api/place/18"
}
],
"books": [
{
"title": "The Dark Tower: The Gunslinger",
"url": "https://stephen-king-api.onrender.com/api/book/12"
},
{
"title": "The Talisman",
"url": "https://stephen-king-api.onrender.com/api/book/16"
},
{
"title": "The Eyes of the Dragon",
"url": "https://stephen-king-api.onrender.com/api/book/17"
},
{
"title": "The Dark Tower II: The Drawing of the Three",
"url": "https://stephen-king-api.onrender.com/api/book/20"
},
{
"title": "The Dark Tower III: The Waste Lands",
"url": "https://stephen-king-api.onrender.com/api/book/25"
},
{
"title": "The Dark Tower IV: Wizard and Glass",
"url": "https://stephen-king-api.onrender.com/api/book/34"
},
{
"title": "The Dark Tower V: Wolves of the Calla",
"url": "https://stephen-king-api.onrender.com/api/book/40"
},
{
"title": "The Dark Tower VI: Song of Susannah",
"url": "https://stephen-king-api.onrender.com/api/book/41"
},
{
"title": "The Dark Tower VII: The Dark Tower",
"url": "https://stephen-king-api.onrender.com/api/book/42"
},
{
"title": "The Dark Tower: The Wind Through the Keyhole",
"url": "https://stephen-king-api.onrender.com/api/book/50"
}
],
"shorts": [
{
"title": "The Little Sisters of Eluria",
"url": "https://stephen-king-api.onrender.com/api/short/139"
}
],
"villains": [
{
"name": "Marten Broadcloak",
"url": "https://stephen-king-api.onrender.com/api/villain/10"
},
{
"name": "Rhea Dubativo",
"url": "https://stephen-king-api.onrender.com/api/villain/32"
},
{
"name": "Eldred Jonas",
"url": "https://stephen-king-api.onrender.com/api/villain/60"
},
{
"name": "Sylvia Pittston",
"url": "https://stephen-king-api.onrender.com/api/villain/84"
},
{
"name": "Ben Slightman",
"url": "https://stephen-king-api.onrender.com/api/villain/178"
}
]
}
],
"pagination": {
"page": 1,
"limit": 1,
"total": 184,
"totalPages": 184
}
}
Returns a single place by ID.
GET https://stephen-king-api.onrender.com/api/place/76
{
"data": {
"id": 76,
"name": "Jerusalem's Lot, Maine",
"handle": "jerusalem-s-lot-maine",
"type": "town",
"created_at": "2026-10-28T20:25:46.000Z",
"parent": {
"name": "Maine",
"url": "https://stephen-king-api.onrender.com/api/place/28"
},
"places": [
{
"name": "Harmony Hill Cemetery",
"url": "https://stephen-king-api.onrender.com/api/place/145"
},
{
"name": "Brock Street School",
"url": "https://stephen-king-api.onrender.com/api/place/157"
},
{
"name": "Jerusalem's Lot Public Library",
"url": "https://stephen-king-api.onrender.com/api/place/169"
},
{
"name": "Marsten House",
"url": "https://stephen-king-api.onrender.com/api/place/170"
},
{
"name": "Stanley Street Elementary School",
"url": "https://stephen-king-api.onrender.com/api/place/173"
}
],
"books": [
{
"title": "Salem's Lot",
"url": "https://stephen-king-api.onrender.com/api/book/2"
}
],
"shorts": [
{
"title": "One for the Road",
"url": "https://stephen-king-api.onrender.com/api/short/54"
},
{
"title": "Jerusalem's Lot",
"url": "https://stephen-king-api.onrender.com/api/short/58"
}
],
"villains": [
{
"name": "Kurt Barlow",
"url": "https://stephen-king-api.onrender.com/api/villain/2"
},
{
"name": "James Boon",
"url": "https://stephen-king-api.onrender.com/api/villain/6"
},
{
"name": "Richard Straker",
"url": "https://stephen-king-api.onrender.com/api/villain/98"
}
]
}
}
Every villain has a broad type: human, vampire, supernatural being, alien, machine or object, ghost, or animal. Under those sit kinds named in the stories themselves, such as Callahan's Type One vampires, the True Knot, and the machines of North Central Positronics. A type lists the kinds inside it and every villain of that type or one of its kinds, so the Vampire type includes the True Knot. A villain's types_id is the id of its broad type.
Returns all types, broad types first. Supports pagination.
GET https://stephen-king-api.onrender.com/api/types?page=2&limit=1
{
"data": [
{
"id": 2,
"name": "Vampire",
"handle": "vampire",
"created_at": "2026-10-30T00:54:07.000Z",
"parent": null,
"types": [
{
"name": "True Knot",
"url": "https://stephen-king-api.onrender.com/api/type/10"
},
{
"name": "Type One vampire",
"url": "https://stephen-king-api.onrender.com/api/type/11"
}
],
"villains": [
{
"name": "Kurt Barlow",
"url": "https://stephen-king-api.onrender.com/api/villain/2"
},
{
"name": "Dandelo",
"url": "https://stephen-king-api.onrender.com/api/villain/21"
},
{
"name": "Rose the Hat",
"url": "https://stephen-king-api.onrender.com/api/villain/31"
},
{
"name": "Little Sisters",
"url": "https://stephen-king-api.onrender.com/api/villain/67"
},
{
"name": "Barry",
"url": "https://stephen-king-api.onrender.com/api/villain/121"
},
{
"name": "Crow Daddy",
"url": "https://stephen-king-api.onrender.com/api/villain/130"
},
{
"name": "Grampa Flick",
"url": "https://stephen-king-api.onrender.com/api/villain/137"
},
{
"name": "Jimmy Numbers",
"url": "https://stephen-king-api.onrender.com/api/villain/142"
},
{
"name": "Snakebite Andi",
"url": "https://stephen-king-api.onrender.com/api/villain/164"
},
{
"name": "Walnut",
"url": "https://stephen-king-api.onrender.com/api/villain/174"
}
]
}
],
"pagination": {
"page": 2,
"limit": 1,
"total": 15,
"totalPages": 15
}
}
Returns a single type by ID. Id 5 is unused: the old database used it for groups, which are now the villain's group flag.
GET https://stephen-king-api.onrender.com/api/type/16
{
"data": {
"id": 16,
"name": "North Central Positronics",
"handle": "north-central-positronics",
"created_at": "2026-10-30T00:54:07.000Z",
"parent": {
"name": "Machine or object",
"url": "https://stephen-king-api.onrender.com/api/type/6"
},
"types": [],
"villains": [
{
"name": "Blaine the Mono",
"url": "https://stephen-king-api.onrender.com/api/villain/3"
},
{
"name": "Andy",
"url": "https://stephen-king-api.onrender.com/api/villain/177"
}
]
}
}
Every short story links to the collection it was published in, such as Night Shift or Skeleton Crew, and a collection lists its stories in id order. A collection that's also a book in the catalog, such as The Dark Tower: The Gunslinger, links to that book, and the book links back with collection. Stories that were never collected have no collection: their collection is null, and collectedIn says "Uncollected".
Returns all collections. Supports pagination.
GET https://stephen-king-api.onrender.com/api/collections?page=2&limit=1
{
"data": [
{
"id": 2,
"name": "The Dark Tower: The Gunslinger",
"handle": "the-dark-tower-the-gunslinger",
"year": 1982,
"created_at": "2026-10-30T01:26:00.000Z",
"book": {
"title": "The Dark Tower: The Gunslinger",
"url": "https://stephen-king-api.onrender.com/api/book/12"
},
"shorts": [
{
"title": "The Gunslinger",
"url": "https://stephen-king-api.onrender.com/api/short/64"
},
{
"title": "The Way Station",
"url": "https://stephen-king-api.onrender.com/api/short/69"
},
{
"title": "The Oracle and the Mountains",
"url": "https://stephen-king-api.onrender.com/api/short/73"
},
{
"title": "The Slow Mutants",
"url": "https://stephen-king-api.onrender.com/api/short/75"
},
{
"title": "The Gunslinger and the Dark Man",
"url": "https://stephen-king-api.onrender.com/api/short/79"
}
]
}
],
"pagination": {
"page": 2,
"limit": 1,
"total": 16,
"totalPages": 16
}
}
Returns a single collection by ID. Ids 16 and 17 are unused: they were Uncollected and Uncollected (standalone book), which are now a null collection.
GET https://stephen-king-api.onrender.com/api/collection/3
{
"data": {
"id": 3,
"name": "Different Seasons",
"handle": "different-seasons",
"year": 1982,
"created_at": "2026-10-30T01:26:00.000Z",
"book": null,
"shorts": [
{
"title": "Apt Pupil",
"url": "https://stephen-king-api.onrender.com/api/short/83"
},
{
"title": "The Body",
"url": "https://stephen-king-api.onrender.com/api/short/84"
},
{
"title": "The Breathing Method",
"url": "https://stephen-king-api.onrender.com/api/short/85"
},
{
"title": "Rita Hayworth and Shawshank Redemption",
"url": "https://stephen-king-api.onrender.com/api/short/86"
}
]
}
}
A short story links to the publication it first appeared in, such as Cavalier, The New Yorker or the anthology Dark Forces, and a publication lists its stories in id order. A publication's type is "magazine", "anthology", "newspaper" or "other", which covers King's own small books, convention books, websites and ebook stores. A magazine or anthology series is one publication, so Shadows holds the stories from Shadows and Shadows 4; the issue and date stay in the story's originallyPublishedIn. Stories that first appeared in their own collection, or as a book of their own, have null.
Returns all publications. Supports pagination.
GET https://stephen-king-api.onrender.com/api/publications?page=1&limit=1
{
"data": [
{
"id": 1,
"name": "Dave's Rag",
"handle": "dave-s-rag",
"type": "newspaper",
"created_at": "2026-10-30T01:50:00.000Z",
"shorts": [
{
"title": "Jumper",
"url": "https://stephen-king-api.onrender.com/api/short/3"
},
{
"title": "Rush Call",
"url": "https://stephen-king-api.onrender.com/api/short/4"
}
]
}
],
"pagination": {
"page": 1,
"limit": 1,
"total": 87,
"totalPages": 87
}
}
Returns a single publication by ID.
GET https://stephen-king-api.onrender.com/api/publication/20
{
"data": {
"id": 20,
"name": "Shadows",
"handle": "shadows",
"type": "anthology",
"created_at": "2026-10-30T01:50:00.000Z",
"shorts": [
{
"title": "Nona",
"url": "https://stephen-king-api.onrender.com/api/short/63"
},
{
"title": "The Man Who Would Not Shake Hands",
"url": "https://stephen-king-api.onrender.com/api/short/76"
}
]
}
}
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier |
Year |
integer | Year of publication |
Title |
string | Book title |
handle |
string | URL-friendly slug |
Publisher |
string | Publisher name |
ISBN |
string | ISBN identifier |
Pages |
integer | Page count |
Notes |
string[] | Additional notes |
villains |
array | Associated villains with name and URL |
places |
array | Places the story is set in, with name and URL, broadest first |
collection |
object? | The collection this book is, with name and URL, or null for most books |
created_at |
datetime | Record creation timestamp |
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier |
title |
string | Story title |
type |
string | Type of work: "short story", "novella", "poem", "play", "teleplay" or "screenplay" |
handle |
string | URL-friendly slug |
originallyPublishedIn |
string | Original publication |
publication |
object? | The magazine, anthology or other publication it first appeared in, with name and URL, or null when it first appeared in its collection or on its own, or when nothing is recorded |
collectedIn |
string | Collection it appears in, with its year, such as "Night Shift (1978)" |
collection |
object? | The same collection, with name and URL, or null for a story that was never collected |
notes |
string[] | Additional notes |
year |
integer | Year of publication |
villains |
array | Associated villains with name and URL |
places |
array | Places the story is set in, with name and URL, broadest first |
created_at |
datetime | Record creation timestamp |
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier |
name |
string | Villain name |
gender |
string? | "Male", "Female", "Unknown", or null |
status |
string | "Deceased" or "Alive" |
types_id |
integer | Id of the villain's broad type (see type) |
group |
boolean | Whether the record is a set of villains, such as a gang, a cult or a race |
notes |
string[] | Additional notes |
books |
array | Associated books with title and URL |
shorts |
array | Associated short stories with title and URL |
residence |
array | Where the villain lives, with name and URL |
type |
object | The villain's broad type, with name and URL |
kinds |
array | Kinds from the stories the villain belongs to, such as the True Knot, with name and URL |
created_at |
datetime | Record creation timestamp |
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier |
name |
string | Place name, as the Stephen King Wiki titles it |
handle |
string | URL-friendly slug |
type |
string | "world", "region", "country", "state", "town", "landmark" or "building" |
parent |
object? | The place it's in, with name and URL, or null for a world, a country, or a place the stories don't put anywhere named |
places |
array | The places inside it, with name and URL |
books |
array | Books set there, with title and URL |
shorts |
array | Short stories set there, with title and URL |
villains |
array | Villains who live there or in a place inside it, with name and URL |
created_at |
datetime | Record creation timestamp |
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier |
name |
string | Type name |
handle |
string | URL-friendly slug |
created_at |
datetime | Record creation timestamp |
parent |
object? | The broad type a kind belongs to, with name and URL, or null for a broad type |
types |
array | The kinds inside it, with name and URL |
villains |
array | Villains of this type or a kind inside it, with name and URL |
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier |
name |
string | Collection title |
handle |
string | URL-friendly slug |
year |
integer | Year of publication |
created_at |
datetime | Record creation timestamp |
book |
object? | The catalog book this collection is, with title and URL, or null |
shorts |
array | The stories in it, with title and URL, in id order |
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier |
name |
string | Magazine, anthology or other title, without the issue |
handle |
string | URL-friendly slug |
type |
string | "magazine", "anthology", "newspaper" or "other" |
created_at |
datetime | Record creation timestamp |
shorts |
array | The stories that first appeared in it, with title and URL, in id order |