Vermont APIvermont.com ↗
Retrieve Vermont.com community event details by URL or slug. Get title, date, time, venue, address, description, and external links in one API call.
What is the Vermont API?
The Vermont.com API exposes 1 endpoint — get_event_by_url — that returns 9 structured fields for any event listed on Vermont.com's community calendar. Pass a full event URL or just the slug (e.g. vermont-brewers-festival) to get the event title, date, time, venue name, physical address, featured image, full description, and organizer website in a single response.
curl -X GET 'https://api.parse.bot/scraper/d4c54d4f-a56e-4d88-8198-65b6ca49f363/get_event_by_url?url=https%3A%2F%2Fvermont.com%2Fcalendar%2Fvermont-brewers-festival%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 vermont-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: Vermont.com Events SDK — bounded, re-runnable; every call capped."""
from parse_apis.vermont_com_api import Vermont, EventNotFound
client = Vermont()
# Fetch an event by its full URL.
event = client.events.get(url="https://vermont.com/calendar/vermont-brewers-festival/")
print(event.title, event.date, event.time)
print(event.venue, event.address)
# Fetch by slug alone — the SDK resolves it.
try:
detail = client.events.get(url="quilt-exhibition-birthday-party")
print(detail.title, detail.venue, detail.description[:80])
except EventNotFound as e:
print("gone:", e.url)
print("exercised: events.get")
Retrieve full details of a community event from its vermont.com calendar page. Accepts either a full URL (e.g. https://vermont.com/calendar/vermont-brewers-festival/) or just the event slug (e.g. vermont-brewers-festival). Returns title, date, time, venue, address, description, event website link, and featured image when available.
| Param | Type | Description |
|---|---|---|
| urlrequired | string | Full vermont.com event URL (e.g. https://vermont.com/calendar/vermont-brewers-festival/) or the event slug (e.g. vermont-brewers-festival). |
{
"type": "object",
"fields": {
"url": "canonical vermont.com URL for the event",
"date": "event date as displayed (e.g. July 17, 2026)",
"time": "event start time (e.g. 5:30 pm)",
"title": "event name",
"venue": "venue or organizer name",
"address": "physical address from the embedded map",
"image_url": "featured image URL",
"description": "full event description text",
"event_website": "external URL for the event organizer's page"
},
"sample": {
"data": {
"url": "https://vermont.com/calendar/vermont-brewers-festival/",
"date": "July 17, 2026",
"time": "5:30 pm",
"title": "Vermont Brewers Festival",
"venue": "Vermont Brewers Association",
"address": "Waterfront Park (10 College St, Burlington, VT 05401)",
"image_url": "https://vermont.com/wp-content/uploads/2026/04/ff-80bfcd178e5d754c4030f30e6f37790d-ff-VBF-Photo.jpg",
"description": "Established in 1991, the Vermont Brewers Festival is a successful two-day premier craft beer event on the waterfront in Burlington, Vermont.",
"event_website": "https://www.vermontbrewers.com/events/vermont-brewers-festival/"
},
"status": "success"
}
}About the Vermont API
What the API Returns
The get_event_by_url endpoint accepts either a complete vermont.com calendar URL (e.g. https://vermont.com/calendar/vermont-brewers-festival/) or a bare slug (e.g. vermont-brewers-festival). The response includes the canonical url, human-readable date (e.g. "July 17, 2026"), time (e.g. "5:30 pm"), title, venue, and a description containing the full event body text as displayed on the listing page.
Location and Media Fields
Each response also includes address, pulled from the embedded map on the event page, giving you a physical location string you can pass directly to a geocoder or display in a map widget. The image_url field points to the featured image for the event, and event_website provides the external URL to the event organizer's own page — useful for linking out or scraping deeper details from the organizer directly.
Input Flexibility
The single required parameter url is forgiving: both the full vermont.com URL format and the event slug alone are accepted. This means you can store slugs from a Vermont.com listing page and resolve them to full details without pre-processing the URLs in your pipeline.
The Vermont API is a managed, monitored endpoint for vermont.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when vermont.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 vermont.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 Vermont events aggregator by resolving a list of slugs to full event records including date, time, and venue
- Populate a travel itinerary app with Vermont community events using date, address, and description fields
- Display a map of upcoming Vermont events by extracting the address field and geocoding each result
- Monitor Vermont brewery, festival, and cultural events by tracking changes to event descriptions and dates
- Generate a weekly Vermont events digest by pulling title, date, time, and event_website for newsletter formatting
- Enrich a tourism recommendation engine with structured Vermont event data including featured images and venue names
| 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 Vermont.com have an official developer API?+
What does the address field contain, and is it always present?+
address field contains the physical location string from the map embedded on the event page. If an event has no mapped location — for example, a virtual or organizer-only event — the field may be empty or absent. Always check for a null or empty value before passing it to a geocoder.Can I search or browse events by date range, category, or region rather than fetching by individual URL?+
Does the API return recurring event instances separately?+
Is the event_website field always an external URL?+
event_website field reflects whatever external link the event organizer has provided on their Vermont.com listing. Some events may not include an organizer URL, in which case the field will be empty or null. It is not guaranteed to be present for every event.