API Docs

Introduction

The Stephen King API is a free, open-source REST API providing data about Stephen King's novels, short stories, and villains. 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.

Base URL

All endpoints described below are relative to this base URL.

Pagination

All list endpoints support optional pagination via query parameters:

Both page and limit must be provided together to enable pagination. Without them, all results are returned.

Without pagination

{
  "data": [ ... ]
}

With pagination

{
  "data": [ ... ],
  "pagination": {
    "page": 1,
    "limit": 5,
    "total": 75,
    "totalPages": 15
  }
}

Books

{
  "data": [
    {
      "id": 1,
      "Year": 1974,
      "Title": "Carrie",
      "handle": "carrie",
      "Publisher": "Doubleday",
      "ISBN": "978-0-385-08695-0",
      "Pages": 199,
      "Notes": [
        "King's first published novel"
      ],
      "villains": [
        {
          "name": "Margaret White",
          "url": "https://stephen-king-api.onrender.com/api/villain/2"
        }
      ],
      "created_at": "2023-09-17T00:00:00.000Z"
    },
    {
      "id": 2,
      "Year": 1975,
      "Title": "'Salem's Lot",
      "handle": "salem-s-lot",
      "Publisher": "Doubleday",
      "ISBN": "978-0-385-00751-1",
      "Pages": 439,
      "Notes": [],
      "villains": [
        {
          "name": "Kurt Barlow",
          "url": "https://stephen-king-api.onrender.com/api/villain/1"
        }
      ],
      "created_at": "2023-09-17T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 2,
    "total": 75,
    "totalPages": 38
  }
}

{
  "data": {
    "id": 3,
    "Year": 1977,
    "Title": "The Shining",
    "handle": "the-shining",
    "Publisher": "Doubleday",
    "ISBN": "978-0-385-12167-5",
    "Pages": 447,
    "Notes": [],
    "villains": [
      {
        "name": "Jack Torrance",
        "url": "https://stephen-king-api.onrender.com/api/villain/3"
      }
    ],
    "created_at": "2023-09-17T00:00:00.000Z"
  }
}

Short Stories

{
  "data": [
    {
      "id": 1,
      "title": "Jerusalem's Lot",
      "type": "Short Story",
      "handle": "jerusalems-lot",
      "originallyPublishedIn": "Night Shift",
      "collectedIn": "Night Shift",
      "notes": [],
      "year": 1978,
      "villains": [
        {
          "name": "Kurt Barlow",
          "url": "https://stephen-king-api.onrender.com/api/villain/1"
        }
      ],
      "created_at": "2023-09-17T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 200,
    "totalPages": 200
  }
}

{
  "data": {
    "id": 2,
    "title": "Graveyard Shift",
    "type": "Short Story",
    "handle": "graveyard-shift",
    "originallyPublishedIn": "Cavalier",
    "collectedIn": "Night Shift",
    "notes": [],
    "year": 1970,
    "villains": [],
    "created_at": "2023-09-17T00:00:00.000Z"
  }
}

Villains

Villain responses include books and shorts arrays (instead of a villains array) linking to the works they appear in.

{
  "data": [
    {
      "id": 1,
      "name": "Kurt Barlow",
      "gender": "Male",
      "status": "Undead",
      "types_id": 1,
      "notes": [],
      "created_at": "2023-09-17T00:00:00.000Z",
      "books": [
        {
          "title": "'Salem's Lot",
          "url": "https://stephen-king-api.onrender.com/api/book/2"
        }
      ],
      "shorts": [
        {
          "title": "Jerusalem's Lot",
          "url": "https://stephen-king-api.onrender.com/api/short/1"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 55,
    "totalPages": 55
  }
}

{
  "data": {
    "id": 3,
    "name": "Jack Torrance",
    "gender": "Male",
    "status": "Deceased",
    "types_id": 2,
    "notes": [],
    "created_at": "2023-09-17T00:00:00.000Z",
    "books": [
      {
        "title": "The Shining",
        "url": "https://stephen-king-api.onrender.com/api/book/3"
      }
    ],
    "shorts": []
  }
}

Data Models

Book

Short Story

Villain