gigstamp

List the cities gigstamp currently covers, with their listing URLs. Call this first: only these cities return data.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List the venues gigstamp tracks in a supported city, from small independent rooms to the city's larger touring venues. Each carries a scale (grassroots|major).

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "oxford",
        "brighton",
        "sheffield"
      ],
      "description": "city slug; supported cities: oxford, brighton, sheffield"
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false
}

Search a supported city's upcoming live music and events: band gigs, open mics, comedy nights, jam and folk sessions, festivals, and club nights, spanning grassroots gigs at small independent venues through to major shows at the city's big rooms (the local grassroots scene is front and centre, but coverage aims to be complete). Returns them most imminent first, each with a booking link out (gigstamp does not sell tickets) and a gig-page url to cite. Filter by date range, venue, category, scale (grassroots or major), or free text. Only supported cities return data (see list_cities).

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "oxford",
        "brighton",
        "sheffield"
      ],
      "description": "city slug; supported cities: oxford, brighton, sheffield"
    },
    "from": {
      "type": "string",
      "description": "on or after this local day, YYYY-MM-DD"
    },
    "to": {
      "type": "string",
      "description": "starts on or before this local day, YYYY-MM-DD"
    },
    "venue": {
      "type": "string",
      "description": "venue slug"
    },
    "category": {
      "type": "string",
      "enum": [
        "original",
        "tribute",
        "classical",
        "covers",
        "comedy",
        "openMic",
        "jamSession",
        "folkSession",
        "festival",
        "event"
      ]
    },
    "scale": {
      "type": "string",
      "enum": [
        "grassroots",
        "major"
      ],
      "description": "narrow to grassroots (small independent venues) or major (large / touring rooms)"
    },
    "query": {
      "type": "string",
      "description": "free-text match over act / venue / summary"
    },
    "tributes": {
      "type": "boolean",
      "description": "include tribute acts (default false)"
    },
    "classical": {
      "type": "boolean",
      "description": "include classical concerts (default true; false hides them)"
    },
    "covers": {
      "type": "boolean",
      "description": "include covers bands and covers nights (default true; false hides them)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "max results (default 100)"
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false
}

Get one gig by its slug within a supported city.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "oxford",
        "brighton",
        "sheffield"
      ],
      "description": "city slug; supported cities: oxford, brighton, sheffield"
    },
    "slug": {
      "type": "string",
      "description": "the gig's url slug"
    }
  },
  "required": [
    "city",
    "slug"
  ],
  "additionalProperties": false
}