openapi.yaml

openapi: 3.0.0
info:
  title: XKCD
  description: Webcomic of romance, sarcasm, math, and language.
  version: 1.0.0
  x-apisguru-categories:
    - media
  x-logo:
    url: http://imgs.xkcd.com/static/terrible_small_logo.png
  x-origin:
    - version: '3.0'
      format: openapi
      url: >-
        https://raw.githubusercontent.com/APIs-guru/unofficial_openapi_specs/master/xkcd.com/1.0.0/openapi.yaml
  x-providerName: xkcd.com
  x-tags:
    - humor
    - comics
  x-unofficialSpec: true
  x-api-status-urls:
    - https://xkcd.com
servers:
  - url: http://xkcd.com
tags:
  - name: Info
paths:
  /info.0.json:
    get:
      tags:
        - Info
      operationId: Info_getComicMetadata
      description: |
        Fetch current comic and metadata.
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/comic'
  /{comicId}/info.0.json:
    get:
      tags:
        - Info
      operationId: Info_getById
      description: |
        Fetch comics and metadata  by comic id.
      parameters:
        - in: path
          name: comicId
          required: true
          schema:
            type: number
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/comic'
components:
  schemas:
    comic:
      properties:
        title:
          type: string
        alt:
          type: string
        day:
          type: string
        img:
          type: string
        link:
          type: string
        month:
          type: string
        news:
          type: string
        num:
          type: number
        safe_title:
          type: string
        transcript:
          type: string
        year:
          type: string
      type: object
externalDocs:
  url: https://xkcd.com/json.html