Event Bucket Developer API

A real-time JSON feed of community events from every Event Bucket city. Perfect for tourism bureaus, hyperlocal apps, AI integrations, newsrooms, and anyone building software that needs to know what is happening in a city, county, or state.

Free tier available. 1,000 requests per month at no cost, with attribution. Paid tiers start at $29/month. Signup takes 30 seconds.

Pricing

Free

Community

$0/mo

For civic research, student projects, and small hyperlocal apps.

1,000 requests / month
All public endpoints
Attribution required
Email support

Get Free Key

Rotate Your API Key

If your API key has been exposed (committed to a public repo, shared accidentally, leaked from a former contractor's machine), rotate it here. Your old key stops working immediately and a brand-new key is created with the same tier and limits. The new key is emailed to your registered address.

Rotate my key now

Quick Start

Every request needs an Authorization header (or ?api_key= query param):

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://www.theeventbucket.com/api/events/state?state=MO

Response

[
  {
    "id": "abc-123",
    "name": "Waynesville Fall Festival",
    "eventType": "Festival",
    "city": "Waynesville",
    "citySlug": "waynesvillemo",
    "location": "Veterans Memorial Park",
    "startDate": "2026-10-15",
    "endDate": "2026-10-17",
    "startTime": "10:00",
    "endTime": "22:00",
    "cost": "Free",
    "description": "Three days of live music, food trucks, and family activities.",
    "flyerURL": "https://res.cloudinary.com/...",
    "website": "https://...",
    "url": "https://www.theeventbucket.com/waynesvillemo/"
  }
]

Endpoints

GET /api/events/state

Returns all approved, upcoming events for a given state.

Query params:
  state     required  Two-letter state code (e.g. MO)
  category  optional  Filter by category (Community, Music, Yard Sale, etc.)
  location  optional  Filter by city name substring

Rate Limits

Every response includes the following headers:

X-RateLimit-Limit:     10000
X-RateLimit-Remaining: 9847
X-RateLimit-Tier:      developer
X-Attribution-Required: Powered by Event Bucket (https://www.theeventbucket.com)

When you hit your monthly quota, the API returns HTTP 429. Upgrade to a higher tier at any time by subscribing with the same email you used at signup, your key will be upgraded automatically within a minute. Questions? sean@wilwellcompany.com.

Attribution

Free-tier integrations must display attribution wherever Event Bucket data is shown publicly. Suggested format:

Powered by Event Bucket
https://www.theeventbucket.com

Paid tiers may remove the attribution requirement.

Terms of Use

Commercial use requires a paid tier or custom license. You may use the free tier for civic research, student projects, and hyperlocal apps with attribution. Any application that monetizes Event Bucket data, redistributes it at scale, or uses it for AI model training requires a paid or enterprise license. Unauthorized scraping is a Terms of Service violation and may be blocked.

Full terms at theeventbucket.com/terms.

Event Bucket Developer API

Pricing

Get a Free API Key

Rotate Your API Key

Quick Start

Response

Endpoints

GET /api/events/state

Rate Limits

Attribution

Terms of Use