Viberate General Event API

The General Event API from Viberate — 4 operation(s) for general event.

Operations 4

GET /event/{uuid}/details Event's Details #
GET /event/{uuid}/lineup Event's Lineup #
GET /event/search Event search #
GET /event/by-channel/{channelName}/{linkID} Event Search by Channel #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/viberate:viberate-general-event-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

viberate-general-event-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Viberate General Event API
  description: '# Introduction

    Welcome to Viberate API, your source of daily-refreshed data on millions of music entities.'
  version: 1.24.0
  x-logo:
    url: https://viberate.ams3.cdn.digitaloceanspaces.com/share/docs-logo.png
    altText: Viberate logo
    href: https://www.viberate.com/home
servers:
- url: https://data.viberate.com/api/v1
security:
- Access-Key: []
tags:
- name: General Event
  x-displayName: General
paths:
  /event/{uuid}/details:
    get:
      summary: Event's Details
      tags:
      - General Event
      description: Get detailed information about the event.
      parameters:
      - in: path
        name: uuid
        required: true
        description: "\n\nEvent UUID \n\n*Example: `903622a1-736b-435b-a800-4231690cd989`*"
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_version:
                    type: string
                    example: v1.24.0
                  data:
                    type: object
                    properties:
                      uuid:
                        type: string
                        example: a733a382-6bce-4185-8bbd-338f21955c37
                      name:
                        type: string
                        example: DEAD CHIC at Rough Trade - West
                      slug:
                        type: string
                        example: dead-chic-at-rough-trade-west
                      venue:
                        type: object
                        properties:
                          uuid:
                            type: string
                            example: e72a58bb-471d-4f6a-94f5-5d6a2e4caa60
                          name:
                            type: string
                            example: Rough Trade - West
                          slug:
                            type: string
                            example: rough-trade-west
                      genres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 4
                            name:
                              type: string
                              example: R&B
                            slug:
                              type: string
                              example: rnb
                        example:
                        - id: 4
                          name: R&B
                          slug: rnb
                      subgenres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 16
                            name:
                              type: string
                              example: Soul
                            slug:
                              type: string
                              example: soul
                        example:
                        - id: 16
                          name: Soul
                          slug: soul
                        - id: 76
                          name: Blues Rock
                          slug: blues-rock
                      start:
                        type: string
                        example: '2024-11-12T17:00:00'
                      status:
                        type: string
                        example: active
        '400':
          description: invalid_request
        '404':
          description: not_found
        '500':
          description: internal_server_error
      operationId: getEventByUuidDetails
      x-operation-id-source: derived
  /event/{uuid}/lineup:
    get:
      summary: Event's Lineup
      tags:
      - General Event
      description: Get detailed information about the event lineup.
      parameters:
      - in: path
        name: uuid
        required: true
        description: "\n\nEvent UUID \n\n*Example: `903622a1-736b-435b-a800-4231690cd989`*"
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_version:
                    type: string
                    example: v1.24.0
                  data:
                    type: object
                    properties:
                      uuid:
                        type: string
                        example: a733a382-6bce-4185-8bbd-338f21955c37
                      name:
                        type: string
                        example: DEAD CHIC at Rough Trade - West
                      slug:
                        type: string
                        example: dead-chic-at-rough-trade-west
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            uuid:
                              type: string
                              example: 87b9a8a3-547a-4172-aba6-bea1182564f8
                            name:
                              type: string
                              example: DEAD CHIC
                            slug:
                              type: string
                              example: dead-chic
                        example:
                        - uuid: 87b9a8a3-547a-4172-aba6-bea1182564f8
                          name: DEAD CHIC
                          slug: dead-chic
        '400':
          description: invalid_request
        '404':
          description: not_found
        '500':
          description: internal_server_error
      operationId: getEventByUuidLineup
      x-operation-id-source: derived
  /event/search:
    get:
      summary: Event search
      tags:
      - General Event
      description: Search for events by their name. Search is elastic, so approximates can provide correct search results.
      parameters:
      - in: query
        name: q
        required: true
        description: '


          Event''s name'
        schema:
          type: string
      - in: query
        name: limit
        required: false
        description: '


          Maximum number of results per page'
        schema:
          type: integer
          default: 20
      - in: query
        name: offset
        required: false
        description: Offset of results
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_version:
                    type: string
                    example: v1.24.0
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          example: a733a382-6bce-4185-8bbd-338f21955c37
                        name:
                          type: string
                          example: DEAD CHIC at Rough Trade - West
                        slug:
                          type: string
                          example: dead-chic-at-rough-trade-west
                        venue:
                          type: object
                          properties:
                            uuid:
                              type: string
                              example: e72a58bb-471d-4f6a-94f5-5d6a2e4caa60
                            name:
                              type: string
                              example: Rough Trade - West
                            slug:
                              type: string
                              example: rough-trade-west
                        genres:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: integer
                                example: 4
                              name:
                                type: string
                                example: R&B
                              slug:
                                type: string
                                example: rnb
                          example:
                          - id: 4
                            name: R&B
                            slug: rnb
                        subgenres:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: integer
                                example: 16
                              name:
                                type: string
                                example: Soul
                              slug:
                                type: string
                                example: soul
                          example:
                          - id: 16
                            name: Soul
                            slug: soul
                          - id: 76
                            name: Blues Rock
                            slug: blues-rock
                        start:
                          type: string
                          example: '2024-11-12T17:00:00'
                        status:
                          type: string
                          example: active
                    example:
                    - uuid: a733a382-6bce-4185-8bbd-338f21955c37
                      name: DEAD CHIC at Rough Trade - West
                      slug: dead-chic-at-rough-trade-west
                      venue:
                        uuid: e72a58bb-471d-4f6a-94f5-5d6a2e4caa60
                        name: Rough Trade - West
                        slug: rough-trade-west
                      genres:
                      - id: 4
                        name: R&B
                        slug: rnb
                      subgenres:
                      - id: 16
                        name: Soul
                        slug: soul
                      - id: 76
                        name: Blues Rock
                        slug: blues-rock
                      start: '2024-11-12T17:00:00'
                      status: active
                    - uuid: 481dfe82-db62-4169-9614-96a977443cd8
                      name: Skydaddy at Dead Wax Digbeth
                      slug: skydaddy-at-dead-wax-digbeth
                      venue:
                        uuid: 1282ee8c-20ff-4402-b8d5-1f746aee2f6b
                        name: Dead Wax Digbeth
                        slug: dead-wax-digbeth
                      genres:
                      - id: 7
                        name: Rock
                        slug: rock
                      subgenres:
                      - id: 45
                        name: Psychedelic Rock
                        slug: psychedelic-rock
                      start: '2025-01-29T19:30:00'
                      status: active
                    - uuid: 6ab91de4-a24a-41fc-b40b-df02090e4e05
                      name: SHADER at Dead Wax Digbeth
                      slug: shader-at-dead-wax-digbeth
                      venue:
                        uuid: 1282ee8c-20ff-4402-b8d5-1f746aee2f6b
                        name: Dead Wax Digbeth
                        slug: dead-wax-digbeth
                      genres:
                      - id: 7
                        name: Rock
                        slug: rock
                      subgenres:
                      - id: 43
                        name: Indie Rock
                        slug: indie-rock
                      start: '2024-12-06T19:30:00'
                      status: active
                    - uuid: 4fa563f1-fc57-48c5-aeac-eec7c424f852
                      name: The Bleeding at Dead Wax Digbeth
                      slug: the-bleeding-at-dead-wax-digbeth
                      venue:
                        uuid: 1282ee8c-20ff-4402-b8d5-1f746aee2f6b
                        name: Dead Wax Digbeth
                        slug: dead-wax-digbeth
                      genres:
                      - id: 8
                        name: Metal
                        slug: metal
                      subgenres:
                      - id: 52
                        name: Death Metal
                        slug: death-metal
                      - id: 60
                        name: Thrash Metal
                        slug: thrash-metal
                      start: '2024-11-16T20:00:00'
                      status: active
                    - uuid: 88f63827-2db6-44d5-b8c4-174191499fe8
                      name: Danny Wright at Dead Wax Digbeth
                      slug: danny-wright-at-dead-wax-digbeth
                      venue:
                        uuid: 1282ee8c-20ff-4402-b8d5-1f746aee2f6b
                        name: Dead Wax Digbeth
                        slug: dead-wax-digbeth
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      - id: 50
                        name: Pop Rock
                        slug: pop-rock
                      start: '2024-11-24T19:00:00'
                      status: active
                    - uuid: 01a37cef-dafb-47fe-8fb8-19ab1e5dafdd
                      name: Prettier than Matt at Dead Dog Saloon
                      slug: prettier-than-matt-at-dead-dog-saloon-097
                      venue:
                        uuid: c1b50f12-ec73-44bf-8db2-5032f4e09fb4
                        name: Dead Dog Saloon
                        slug: dead-dog-saloon
                      genres:
                      - id: 1
                        name: Country
                        slug: country
                      subgenres:
                      - id: 2
                        name: Americana/Alt Country
                        slug: americana-alt-country
                      - id: 9
                        name: Indie Pop
                        slug: indie-pop
                      start: '2024-11-12T18:00:00'
                      status: active
                    - uuid: bc5dd2bb-d4e2-4bcf-8600-9beb560bc45e
                      name: The Pale White at Dead Wax Digbeth
                      slug: the-pale-white-at-dead-wax-digbeth
                      venue:
                        uuid: 1282ee8c-20ff-4402-b8d5-1f746aee2f6b
                        name: Dead Wax Digbeth
                        slug: dead-wax-digbeth
                      genres:
                      - id: 7
                        name: Rock
                        slug: rock
                      subgenres:
                      - id: 43
                        name: Indie Rock
                        slug: indie-rock
                      - id: 9
                        name: Indie Pop
                        slug: indie-pop
                      start: '2025-03-10T19:00:00'
                      status: active
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                        example: 2225
                      current:
                        type: integer
                        example: 20
                      limit:
                        type: integer
                        example: 20
                      offset:
                        type: integer
                        example: 0
        '400':
          description: invalid_request
        '404':
          description: not_found
        '500':
          description: internal_server_error
      operationId: getEventSearch
      x-operation-id-source: derived
  /event/by-channel/{channelName}/{linkID}:
    get:
      summary: Event Search by Channel
      tags:
      - General Event
      description: Search for events by their channel ID.
      parameters:
      - in: path
        name: channelName
        required: true
        description: 'Channel name


          *Example: `songkick`*'
        schema:
          type: string
      - in: path
        name: linkID
        required: true
        description: 'Channel ID


          *Example: `42249658`*'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_version:
                    type: string
                    example: v1.12.1
                  data:
                    type: object
                    properties:
                      uuid:
                        type: string
                        example: a733a382-6bce-4185-8bbd-338f21955c37
                      name:
                        type: string
                        example: DEAD CHIC at Rough Trade - West
                      slug:
                        type: string
                        example: dead-chic-at-rough-trade-west
                      venue:
                        type: object
                        properties:
                          uuid:
                            type: string
                            example: e72a58bb-471d-4f6a-94f5-5d6a2e4caa60
                          name:
                            type: string
                            example: Rough Trade - West
                          slug:
                            type: string
                            example: rough-trade-west
                      genres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 4
                            name:
                              type: string
                              example: R&B
                            slug:
                              type: string
                              example: rnb
                        example:
                        - id: 4
                          name: R&B
                          slug: rnb
                      subgenres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 16
                            name:
                              type: string
                              example: Soul
                            slug:
                              type: string
                              example: soul
                        example:
                        - id: 16
                          name: Soul
                          slug: soul
                        - id: 76
                          name: Blues Rock
                          slug: blues-rock
                      start:
                        type: string
                        example: '2024-11-12T17:00:00'
                      status:
                        type: string
                        example: active
        '400':
          description: invalid_request
        '404':
          description: not_found
        '500':
          description: internal_server_error
      operationId: getEventByChannelByChannelNameByLinkID
      x-operation-id-source: derived
components:
  securitySchemes:
    Access-Key:
      type: apiKey
      description: API key to authorize requests.
      name: Access-Key
      in: header
x-tagGroups:
- name: ''
  tags:
  - MCP Connection Guide
- name: ''
  tags:
  - Rate Limiting
- name: ''
  tags:
  - Viberate Entity IDs
- name: Artist
  tags:
  - General
  - Airplay
  - Beatport
  - Deezer
  - Facebook
  - Instagram
  - TikTok
  - Shazam
  - Social Media
  - Soundcloud
  - Spotify
  - Viberate
  - Youtube
  - Apple Music
- name: Track
  tags:
  - General Track
  - Airplay Track
  - Deezer Track
  - Facebook Track
  - Instagram Track
  - Twitter Track
  - TikTok Track
  - Shazam Track
  - Social Track
  - Soundcloud Track
  - Spotify Track
  - Apple Track
  - Viberate Track
  - Youtube Track
  - Trending Track
- name: Label
  tags:
  - General Label
  - Spotify Label
  - Viberate Label
- name: Event
  tags:
  - General Event
- name: Venue
  tags:
  - General Venue
  - Viberate Venue
- name: Spotify Playlist
  tags:
  - General Playlist
  - Viberate Playlist
- name: Apple Playlist
  tags:
  - General Apple Playlist
  - Viberate Apple Playlist
- name: Festival
  tags:
  - General Festival
  - Instagram Festival
  - TikTok Festival
  - Spotify Festival
  - Viberate Festival
  - Youtube Festival
- name: City
  tags:
  - General City
  - Viberate City