Quick start guide

Getting Started

To start using LocalEvents API, you'll need an API key. Sign up for an account to get your key.

curl -X GET "https://api.localeventsapi.com/v1/events" \
-H "Authorization: Bearer YOUR_API_KEY"

Authentication

All API requests require authentication using your API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get Events by Location

Retrieve events in a specific location.

GET /v1/events?location=San+Francisco

Get Events by Date Range

Find events within a specific date range.

GET /v1/events?start_date=2024-03-01&end_date=2024-03-31

Get Event Details

Get detailed information about a specific event.

GET /v1/events/{event_id}

Response Format

All responses are returned in JSON format:

{ "status": "success", "data": { "events": [ { "id": "evt_123", "title": "Summer Music Festival", "date": "2024-07-15", "location": "San Francisco, CA", "category": "music" } ], "pagination": { "total": 100, "page": 1, "per_page": 10 } } }