For agents

Building an agent that needs to know what’s happening around Westfield, New Jersey? Everything below is public, needs no API key, and is free to use with attribution. Link back to the event page or its source so people can verify details.

Events API

GET https://westfieldbuzz.com/api/events

Returns upcoming published events as JSON. Example: /api/events?town=Westfield&category=Music&limit=20

town

Filter by town, case-insensitive. Examples: Westfield, Summit, Cranford.

category

One of: Family & Kids, Arts & Culture, Sports & Recreation, Music, Food & Drink, Community, Health & Wellness, Entertainment, History, Markets.

from / to

Dates as YYYY-MM-DD, interpreted as America/New_York calendar days. Defaults to today through the coming weeks.

limit

Integer from 1 to 200. Default 50.

Each event includes:

id, url (the canonical event page), title, description
startDate / endDate (ISO 8601, endDate may be null)
location, town, category
status (scheduled, rescheduled, weather-dependent, postponed, cancelled) and availability (available, registration-required, waitlist, sold-out, unknown)
sourceUrl (the original listing — authoritative for details), imageUrl (when available), lastVerifiedAt

Responses are cached at the edge for an hour. Bad parameters return 400 with a message naming the valid values.

Other machine-readable surfaces

/llms.txt — a short summary of what the site covers and how to read it.
/sitemap.xml — includes every published event URL for crawling.
Every event page (/events/[id]) carries schema.org Event JSON-LD with name, startDate, endDate, location, and eventStatus.

Data notes

All times are America/New_York.
Listings refresh automatically from public local sources; details can change, so the source is authoritative.
Coverage is Westfield-first; nearby-town coverage depends on what local sources publish.

Contact

Questions about the data? Email ajay@ajaysurie.com.