API Keys

Generate keys for your LiveSpots app to pull approved venues and events.

Active Keys (1)

livespotsapp-frontendActive

ls_0994f••••••••••••••••Created 3/18/2026

venues:readevents:read

API Reference

Base URL: https://livespots.app/api/v1

Authentication

Pass your API key in the X-API-Key header or as a ?apikey= query parameter.

// Header (recommended)
fetch("https://livespots.app/api/v1/events", {
  headers: { "X-API-Key": "ls_your_key_here" }
});

// Query param (for quick testing)
fetch("https://livespots.app/api/v1/events?apikey=ls_your_key_here");

Endpoints

GET/api/v1/venuesPaginated list of approved venues

Params: state, city, type, vibe, search, limit (max 200), offset

https://livespots.app/api/v1/venues?state=NC&city=Raleigh&type=bar&limit=20

GET/api/v1/venues/:idSingle venue with linked events

Params: id (path param)

https://livespots.app/api/v1/venues/1

GET/api/v1/eventsPaginated list of approved events

Params: venueId, category, dateFrom (YYYY-MM-DD), dateTo, city, search, source, limit, offset

https://livespots.app/api/v1/events?dateFrom=2025-06-01&dateTo=2025-06-30&category=live_music

GET/api/v1/events/:idSingle event detail

Params: id (path param)

https://livespots.app/api/v1/events/42

GET/api/v1/healthHealth check — no auth required

Params: none

https://livespots.app/api/v1/health

Response Shape

{
  "data": [ ...items ],
  "meta": {
    "total": 895,
    "limit": 50,
    "offset": 0,
    "returned": 50
  }
}