BuzzMap API v1
BUZZMAP FOR DEVELOPERS

Your city’s data.
In your app.

Access events, venues, nightlife and local discovery data through one simple, high-performance API.

99.9% Uptime SLA
Sub-50ms Latency
Instant API Key Generation
{
  "status": "OK",
  "request_id": "req_88f921ab902e",
  "data": [
    {
      "id": "evt_12345",
      "name": "Live Jazz at Elephant Room",
      "category": "nightlife",
      "starts_at": "2026-10-15T21:00:00Z",
      "city": "Austin",
      "address": "315 Congress Ave, Austin, TX",
      "latitude": 30.2659,
      "longitude": -97.7437,
      "tickets": [
        {
          "name": "General Admission",
          "price": 15,
          "available": true,
          "max_per_order": 4
        }
      ]
    }
  ],
  "next_cursor": "eyJpZCI6ImV2dF8xMjM0NSJ9"
}

Built for what’s next

Reliable, real-time local data to power your products, experiences and insights.

Event discovery

Access live events, nightlife, food, music and more with rich details, updated every 5 minutes.

Venue data

Get venue information including address, coordinates, category, amenities and live status.

Location intelligence

Tap into real-time crowd levels, trends and city insights to build smarter experiences.

Simple pricing

Choose the plan that fits your build. Upgrade or cancel anytime.

All paid plans billed monthly via Credit / Debit Card through Stripe · Secure checkout · Cancel anytime
Loading plans…
Developer Console

API Keys

Manage your credentials (max 3 active keys). Active keys take effect immediately.

Sign in to view and manage your API keys

Create a developer account in seconds to generate your personal API keys and access real-time event data.

API Reference

Public API Documentation

Explore endpoints, query parameters, schemas, and live response specifications.

Postman Collection v2.1.0 Ready
Quality Filter Guarantee: All events, restaurants, and nightlife spots are actively verified. Coordinates are validated (no placeholder or 0,0 coordinates), images are guaranteed live HTTPS URLs, and ended events are automatically culled. Note: Optional fields (such as description, ends_at, phone, website, or next_cursor) may return as null when not available for a given record.

GET/api/v1/public/events

Retrieve upcoming events filtered by radius, category, or timezone-aware date range.

Query Parameters:
ParameterTypeDescription
lat, lngfloatCenter coordinates (send together)
radius_kmfloat0.1 to 200 (default: 30)
categorystringmusic, nightlife, food, arts, technology
citystringFilter by city (e.g. Lagos, Austin, London)
from, toISO 8601With timezone offset (e.g. 2026-10-28T00:00:00Z)
limitinteger1 to 50 (default: 20)
cursorstringOpaque pagination cursor from next_cursor
Example
curl -H "x-api-key: bzm_live_abc123" \
  "https://api.buzzmap.org/api/v1/public/events?limit=20&cursor=eyJpZCI..."

GET/api/v1/public/events/:id

Fetch complete details, tickets, and coordinates for a single event by ID.

Path Parameters:
ParameterTypeDescription
:idstringUnique event ID (e.g. ev_abc123)
Visual & Spec
{
  "status": "OK",
  "request_id": "req-88f921ab902e",
  "data": {
    "id": "ev_abc123",
    "name": "Lagos Tech Fest 2026",
    "description": "Annual tech conference and networking event",
    "category": "technology",
    "starts_at": "2026-11-15T09:00:00.000Z",
    "address": "Victoria Island Convention Centre",
    "city": "Lagos",
    "country": "Nigeria",
    "latitude": 6.4281,
    "longitude": 3.4219,
    "image_url": "https://cdn.buzzmap.org/images/events/techfest.jpg",
    "tickets": [
      {
        "name": "General Admission",
        "price": 5000,
        "available": true,
        "max_per_order": 5
      }
    ]
  }
}

HeadersRate Limits & Standard HTTP Headers

Every API response returns standard rate-limiting telemetry headers:

HeaderDescription
x-ratelimit-limitPer-minute quota (Free: 60, Pro: 120, Ultra: 240, Mega: 320)
x-ratelimit-remainingRemaining requests in current 1-minute window
x-ratelimit-resetUnix timestamp when the current minute quota resets
retry-afterReturned on HTTP 429 indicating seconds to pause before retrying

JSONStandard Error Envelope

When a request fails or validation rejects parameters, a structured envelope is returned:

{
  "status": "ERROR",
  "request_id": "req-8f92a10c",
  "error": {
    "message": "Invalid query",
    "code": 400,
    "details": [
      "radius_km requires lat and lng"
    ]
  }
}