auto_awesome Getting Started

Introduction

Welcome to the EventAI API. Our platform provides real-time event and happy hour data across all 50 US states. Search by location, filter by category, and integrate live event feeds into your application.

bolt

Real-time Data

Events and happy hours scraped and verified daily across 200+ cities with automated source detection.

location_on

Geo Search

All endpoints support latitude/longitude queries with configurable radius in miles.

Base URL

https://www.eventaiapi.com/api/v1

Authentication

The EventAI API uses API keys to authenticate requests. You can view and manage your API keys in the EventAI Dashboard.

content_copy

1

curl https://www.eventaiapi.com/api/v1/events \

2

  -H "X-API-Key: YOUR_API_KEY" \

3

  -G -d "lat=42.3314" -d "lng=-83.0458"

info

Security Best Practice

Your API keys carry privileges tied to your billing plan. Keep them secure and never expose them in client-side code or public repositories.

Pass your API key via the X-API-Key header on every request.

API Reference

Comprehensive documentation for all available endpoints.

GET /api/v1/events

Search events

Returns events near a given location, sorted by start date. Supports filtering by date range, category, and state.

Query Parameters

lat float

Latitude of search center.

Required

lng float

Longitude of search center.

Required

radius_miles float

Search radius in miles.

Optional

Default: 5.0

date string

Filter events on a specific date (YYYY-MM-DD).

Optional

category string

Filter by event category.

Optional

state string

Filter by state code. All standard US state codes supported (AL through WY, plus DC).

Optional

limit integer

Number of results to return (1-100).

Optional

Default: 20

offset integer

Number of results to skip for pagination.

Optional

Default: 0

Example Response

200 OK

{
  "count": 2,
  "results": [
    {
      "id": "a1b2c3...",
      "name": "Jazz Night",
      "description": "Live jazz...",
      "category": "music",
      "venue": {
        "name": "The Jazz Cafe",
        "city": "Detroit",
        "state": "MI"
      },
      "start_datetime": "2026-03-21T19:00:00Z",
      "entry_fee": "$10"
    }
  ]
}

GET /api/v1/happy-hours

Search happy hours

Returns happy hours near a given location. Filter by day of week or get only currently active specials.

Query Parameters

lat float

Latitude of search center.

Required

lng float

Longitude of search center.

Required

radius_miles float

Search radius in miles.

Optional

Default: 5.0

day integer

ISO weekday (1=Monday, 7=Sunday).

Optional

active_now boolean

Filter to currently active happy hours.

Optional

state string

Filter by state code. All standard US state codes supported (AL through WY, plus DC).

Optional

limit integer

Number of results to return (1-100).

Optional

Default: 20

Example Response

200 OK

{
  "count": 1,
  "results": [
    {
      "id": "d4e5f6...",
      "venue": {
        "name": "The Pub",
        "city": "Ann Arbor",
        "state": "MI"
      },
      "days_of_week": [1,2,3,4,5],
      "start_time": "16:00",
      "end_time": "18:00",
      "specials": [
        "$5 draft beers",
        "Half-price wings"
      ],
      "confidence": 0.95
    }
  ]
}

GET /api/v1/venues

Search venues

Returns venues near a given location. Optionally filter to only venues with active happy hours.

Query Parameters

lat float

Latitude of search center.

Required

lng float

Longitude of search center.

Required

radius_miles float

Search radius in miles.

Optional

Default: 5.0

has_happy_hour boolean

Filter to venues with active happy hours.

Optional

state string

Filter by state code. All standard US state codes supported (AL through WY, plus DC).

Optional

limit integer

Number of results to return (1-100).

Optional

Default: 20

Example Response

200 OK

{
  "count": 1,
  "results": [
    {
      "id": "g7h8i9...",
      "name": "The Jazz Cafe",
      "address": "123 Main St",
      "city": "Detroit",
      "state": "MI",
      "zip_code": "48201",
      "lat": 42.3314,
      "lng": -83.0458,
      "website": "https://...",
      "phone": "313-555-0100"
    }
  ]
}

GET /api/v1/venues/{venue_id}

Get venue details

Returns full details for a single venue, including its active happy hours and upcoming events.

Path Parameters

venue_id UUID

The unique identifier of the venue.

Required

Example Response

200 OK

{
  "id": "g7h8i9...",
  "name": "The Jazz Cafe",
  "city": "Detroit",
  "happy_hours": [...],
  "upcoming_events": [...]
}