Gizz Tapes

API Documentation

nb: The Gizz Tapes API is currently under active development and subject to change.

The API currently comprises a series of static JSON files, available at URLs beginning with https://tapes.kglw.net/api/v1.

https://tapes.kglw.net/api/v1/shows.json

Returns a list of top-level show data for all shows available on Gizz Tapes.

Schema


{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      }
    },
    "required": [
      "id"
    ]
  }
}

Example


[
  {
    "id": "2015-06-12"
  },
  {
    "id": "2015-06-14"
  },
  {
    "id": "2015-06-15"
  },
  {
    "id": "2015-06-19"
  },
  {
    "id": "2015-06-24"
  },
  {
    "id": "2015-07-18"
  },
  {
    "id": "2015-09-02kexp"
  },
  {
    "id": "2015-09-15daytrotter"
  },
  {
    "id": "2015-09-12"
  },
  {
    "id": "2015-09-13"
  },
  {
    "id": "2015-09-15wfuv"
  }
]

https://tapes.kglw.net/api/v1/shows/{show_id}.json

Schema


{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "format": "date"
    },
    "order": {
      "type": "integer"
    },
    "poster_url": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "kglw_net": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "permalink": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "permalink"
      ]
    },
    "venue_id": {
      "type": "integer"
    },
    "tour_id": {
      "type": "integer"
    },
    "recordings": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "uploaded_at": {
          "type": "string",
          "format": "date-time"
        },
        "type": {
          "type": "string",
          "enum": [
            "AUD",
            "MTX",
            "SBD"
          ]
        },
        "source": {
          "type": "string"
        },
        "lineage": {
          "type": "string"
        },
        "taper": {
          "type": "string"
        },
        "files_path_prefix": {
          "type": "string"
        },
        "internet_archive": {
          "type": "object",
          "properties": {
            "is_lma": {
              "type": "boolean"
            }
          },
          "required": [
            "is_lma"
          ]
        },
        "files": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string"
              },
              "length": {
                "type": "number"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "filename",
              "length",
              "title"
            ]
          }
        }
      },
      "required": [
        "id",
        "files_path_prefix",
        "files"
      ]
    }
  },
  "required": [
    "id",
    "date"
  ]
}

Example


{
  "id": "2015-09-02kexp",
  "date": "2015-09-02",
  "order": 1,
  "poster_url": "https://kglw.net/i/poster-art-1678668055.png",
  "notes": "This was an in-studio appearance for radio station <a href=\" https://www.kexp.org/\" target=\"_blank\" rel=\"noreferrer\">KEXP</a> in Seattle. Following the performance Stu & Joey had an 8 minute interview with KEXP DJ <a href=\"https://en.wikipedia.org/wiki/Cheryl_Waters_(radio_personality)\" target=\"_blank\" rel=\"noreferrer\">Cheryl Waters</a>.",
  "title": "",
  "kglw_net": {
    "id": 1678668055,
    "permalink": "king-gizzard-the-lizard-wizard-september-2-2015-kexp-studios-seattle-wa-usa.html"
  },
  "venue_id": 332,
  "tour_id": 43,
  "recordings": {
    "id": "kglw2015-09-02",
    "uploaded_at": "2022-09-04T21:02:07+00:00",
    "files_path_prefix": "https://archive.org/download/kglw2015-09-02/",
    "internet_archive": {
      "is_lma": false
    },
    "files": [
      {
        "filename": "kglw2015-09-02t01.mp3",
        "length": 17.06,
        "title": "Intro"
      },
      {
        "filename": "kglw2015-09-02t02.mp3",
        "length": 583.18,
        "title": "The River"
      },
      {
        "filename": "kglw2015-09-02t03.mp3",
        "length": 202.9,
        "title": "I'm In Your Mind"
      },
      {
        "filename": "kglw2015-09-02t04.mp3",
        "length": 160.25,
        "title": "I'm Not In Your Mind"
      },
      {
        "filename": "kglw2015-09-02t05.mp3",
        "length": 164.69,
        "title": "Cellophane"
      },
      {
        "filename": "kglw2015-09-02t06.mp3",
        "length": 160.56,
        "title": "I'm In Your Mind Fuzz"
      },
      {
        "filename": "kglw2015-09-02t07.mp3",
        "length": 465.8,
        "title": "Interview"
      }
    ]
  }
}