Viberate General Event API
The General Event API from Viberate — 4 operation(s) for general event.
The General Event API from Viberate — 4 operation(s) for general event.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/viberate:viberate-general-event-api"
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.
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: 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