Skip to content

ridvanaltun/xkcd-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

XKCD API

A CORS enabled API for the XKCD comics.

Usage

# api overview
https://xkcd-api.ridvanaltun.vercel.app/api

# latest comic strip
https://xkcd-api.ridvanaltun.vercel.app/api/comics/latest

# random comic strip
https://xkcd-api.ridvanaltun.vercel.app/api/comics/random

# 1000th comic strip
https://xkcd-api.ridvanaltun.vercel.app/api/comics/1000

Example Response (comic strip #2364)

This is the same exact response that the official XKCD API

{
  "month": "9",
  "num": 2364,
  "link": "",
  "year": "2020",
  "news": "",
  "safe_title": "Parity Conservation",
  "transcript": "",
  "alt": "Bloody Mary is made of antimatter. It explains so much.",
  "img": "https://imgs.xkcd.com/comics/parity_conservation.png",
  "title": "Parity Conservation",
  "day": "25",
  "imgRetina": "https://imgs.xkcd.com/comics/parity_conservation_2x.png"
}

Show Image Directly

Just add ?img=true end of url, like:

# latest comic strip image
https://xkcd-api.ridvanaltun.vercel.app/api/comics/latest?img=true

# random comic strip image
https://xkcd-api.ridvanaltun.vercel.app/api/comics/random?img=true

# 1000th comic strip image
https://xkcd-api.ridvanaltun.vercel.app/api/comics/1000?img=true

Example: Latest Comic Strip

Latest Comic Strip

How works?

![Latest Comic Strip](https://xkcd-api.ridvanaltun.vercel.app/api/comics/latest?img=true)