Hello Burlington VT APIhelloburlingtonvt.com ↗
Retrieve Burlington, VT community event details — venue, dates, coordinates, images, and admission — via two endpoints covering event listings and full event records.
What is the Hello Burlington VT API?
The Hello Burlington VT API exposes 2 endpoints that return community event data from helloburlingtonvt.com. Use list_events to pull upcoming events within any date range, or call get_event_by_url to retrieve a full event record including street address, GPS coordinates, admission details, images, start and end times, and category tags. Each event detail response returns at least 11 structured fields.
curl -X GET 'https://api.parse.bot/scraper/5be48683-3a24-43e3-8f0b-829b06edf46b/get_event_by_url?url=%2Fevent%2Fart-amplified-featuring-thea-wren-and-moss-cycle%2F7400%2F' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace helloburlingtonvt-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Hello Burlington VT Events SDK — bounded, re-runnable."""
from parse_apis.Hello_Burlington_VT_Events_API import HelloBurlington, EventNotFound
client = HelloBurlington()
# List upcoming events in a date range, capped at 3 items
for event_summary in client.event_summaries.list(date_from="2026-07-15", date_to="2026-08-15", limit=3):
print(event_summary.title, event_summary.start_date, event_summary.url)
# Drill into the first event's full details
first = client.event_summaries.list(date_from="2026-07-15", date_to="2026-08-15", limit=1).first()
if first:
try:
detail = first.details()
print(detail.title, detail.location, detail.admission)
print(detail.start_date, detail.times_display)
print("Categories:", detail.categories)
except EventNotFound as e:
print("not found:", e.url)
print("exercised: event_summaries.list, EventSummary.details")
Retrieve full details for a single community event given its URL path or full URL. The URL contains an event slug and numeric record ID (e.g. /event/art-amplified/7400/). Returns venue, dates, times, admission, categories, description, coordinates, and images.
| Param | Type | Description |
|---|---|---|
| urlrequired | string | Event URL path or full URL containing the event slug and numeric ID, e.g. /event/art-amplified-featuring-thea-wren-and-moss-cycle/7400/ or the full https://www.helloburlingtonvt.com/event/... URL. |
{
"type": "object",
"fields": {
"zip": "string — ZIP code",
"city": "string — city name",
"phone": "string — contact phone number",
"recid": "string — numeric event record ID",
"state": "string — state abbreviation",
"title": "string — event title",
"images": "array of image URLs",
"address": "string — street address",
"end_date": "string — ISO 8601 end date",
"end_time": "string — end time in HH:MM:SS format or null",
"hostname": "string — host organization name",
"latitude": "number — venue latitude",
"link_url": "string — external website URL for the event",
"location": "string — venue name",
"admission": "string — admission price or 'Free'",
"longitude": "number — venue longitude",
"categories": "array of category name strings",
"recur_type": "integer — recurrence type code (0=one-time)",
"recurrence": "string — recurrence description or null",
"start_date": "string — ISO 8601 start date",
"start_time": "string — start time in HH:MM:SS format",
"description": "string — HTML description of the event",
"times_display": "string — human-readable time range or null"
},
"sample": {
"data": {
"zip": "05401",
"city": "Burlington",
"phone": "+1 (555) 012-3456",
"recid": "7400",
"state": "VT",
"title": "Art Amplified featuring Thea Wren and Moss Cycle",
"images": [
"https://assets.simpleviewinc.com/simpleview/image/upload/crm/vermont/art_amplified.png"
],
"address": "135 Church Street",
"end_date": "2026-07-16T03:59:59.000Z",
"end_time": "20:00:00",
"hostname": "Burlington City Arts",
"latitude": 44.4765863,
"link_url": "https://www.burlingtoncityarts.org/event/art-amplified-featuring-thea-wren-and-moss-cycle",
"location": "BCA Burlington City Arts",
"admission": "Free",
"longitude": -73.2128915,
"categories": [
"Concerts & Live Music"
],
"recur_type": 0,
"recurrence": null,
"start_date": "2026-07-15T04:00:00.000Z",
"start_time": "17:00:00",
"description": "<p>5 PM: Moss Cycle...</p>",
"times_display": "From: 05:00 PM to 08:00 PM"
},
"status": "success"
}
}About the Hello Burlington VT API
Endpoints
The API has two endpoints. list_events accepts date_from and date_to parameters in YYYY-MM-DD format and returns a paginated collection of events sorted by occurrence date. Each item in the events array includes title, start_date, end_date, and a url path you can pass directly to the second endpoint. The total field tells you how many events fall within the requested window.
Event Detail
get_event_by_url accepts a URL path or full URL containing an event slug and numeric record ID — for example /event/art-amplified/7400/. It returns the complete event record: title, recid, address, city, state, zip, phone, start_date / end_date in ISO 8601, end_time in HH:MM:SS (or null), an images array of image URLs, and category and description fields.
Coverage and Data Shape
All events are drawn from the Burlington, Vermont community event calendar maintained by helloburlingtonvt.com, a local tourism resource. The detail endpoint returns geocoordinates alongside the civic address fields, so you can plot events on a map directly from the response. Image URLs are returned as an array, so multi-image events are fully represented.
Pagination
Results from list_events are auto-iterated — the SDK handles pagination internally, so you receive the full result set for the requested date range without manually managing page offsets.
The Hello Burlington VT API is a managed, monitored endpoint for helloburlingtonvt.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when helloburlingtonvt.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official helloburlingtonvt.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Burlington event calendar app using
list_eventsdate range queries andtitle,start_date, andurlfields. - Plot upcoming Burlington events on a map using the coordinates and
addressfields returned byget_event_by_url. - Display event imagery in a local guide by rendering URLs from the
imagesarray. - Aggregate admission and contact details (
phone,address) for a visitor trip-planning tool. - Send automated weekly digests of Burlington events by querying
list_eventswith rolling 7-day date windows. - Filter events by
end_dateandstart_dateto surface multi-day festivals versus single-day events. - Cross-reference
city,state, andzipfields with hotel availability data to build itinerary suggestions.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does helloburlingtonvt.com have an official developer API?+
What does `list_events` return, and how do I narrow results to a specific period?+
list_events returns a total count and an events array, where each item has title, start_date, end_date, and a url path. You control the window entirely through the date_from and date_to parameters — pass ISO dates like 2026-07-01 and 2026-07-31 to get events occurring within that month.Does the API return event categories or tags?+
get_event_by_url. The list_events response does not include category fields — it returns only title, start_date, end_date, and url per event. If you need to filter a listing by category, retrieve individual records via get_event_by_url and inspect the category field there.Does the API cover recurring event instances individually, or only the parent event?+
recid, and the list_events endpoint returns individual occurrence entries within the requested date range. Whether all instances of a recurring series are enumerated depends on how they appear in the source calendar. You can fork this API on Parse and revise it to add filtering or deduplication logic for recurring events if needed.Can I search events by venue name or neighborhood rather than by date?+
list_events and direct record lookup via get_event_by_url. Venue and address fields are available in detail records but there is no venue-based search endpoint. You can fork this API on Parse and revise it to add a venue-filter endpoint.