gohawaii APIgohawaii.com ↗
Search and retrieve Hawaii events from gohawaii.com. Filter by island, paginate results, and get full event details including dates, addresses, and contacts.
What is the gohawaii API?
The gohawaii.com API provides 2 endpoints for discovering and retrieving Hawaii events listed on the official Hawaii Tourism Authority site. Use search_events to query upcoming events across all islands or filter by a specific island, and use get_event_details to fetch a full event record including description, venue address, contact phone, email, and external website.
curl -X POST 'https://api.parse.bot/scraper/c72dde41-5e16-4da7-b8a5-b4b92ee9d46e/search_events' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": "1",
"island": "oahu",
"per_page": "12"
}'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 gohawaii-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: GoHawaii Events SDK — bounded, re-runnable; every call capped."""
from parse_apis.gohawaii_com_api import GoHawaii, Island, EventNotFound
client = GoHawaii()
# Search upcoming events on O'ahu, capped at 3 results
for event in client.events.search(island=Island.OAHU, limit=3):
print(event.title, event.date, event.city)
# Drill down: get the first event and fetch its full details
event = client.events.search(island=Island.MAUI, limit=1).first()
try:
detail = event.details()
print(detail.title, detail.date_time, detail.address)
except EventNotFound as e:
print(f"Event gone: {e.event_path}")
print("exercised: events.search, event.details")
Search upcoming events across the Hawaiian Islands. Results are sorted by date proximity and auto-iterated. Each event includes title, island, city, date, categories, and a URL path usable with the detail endpoint. When island is omitted, events from all islands are returned.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| island | string | Filter events by island name. |
| per_page | integer | Number of events per page. |
{
"type": "object",
"fields": {
"page": "current page number",
"total": "total number of matching events",
"events": "array of event objects with title, island, city, date, categories, url, and more",
"per_page": "number of events per page"
},
"sample": {
"data": {
"page": 1,
"total": 69,
"events": [
{
"nid": "91756",
"url": "https://www.gohawaii.com/islands/o%CA%BBahu/events/49th-annual-prince-lot-hula-festival",
"city": "Honolulu",
"date": "2026-07-14",
"title": "49th Annual Prince Lot Hula Festival",
"island": "Oʻahu",
"end_dates": [
"1784268000",
"1784455199"
],
"categories": [
"Events",
"Craft Fairs",
"Festivals & Parades",
"Hawaiian Culture",
"Hawaiian Music",
"Hula",
"Live Music"
],
"description": "49th Annual Prince Lot Hula Festival",
"start_dates": [
"1784086200",
"1784282400"
]
}
],
"per_page": 5
},
"status": "success"
}
}About the gohawaii API
Searching Events
The search_events endpoint accepts POST requests with optional island, page, and per_page parameters. When island is omitted, results span all Hawaiian Islands. Each event object in the events array includes title, island, city, date, categories, and a url path that serves as the key input to the detail endpoint. The total field in the response lets you calculate how many pages to iterate for a given query.
Retrieving Event Details
The get_event_details endpoint takes an event_path string — for example /islands/o%CA%BBahu/events/49th-annual-prince-lot-hula-festival — obtained directly from search_events results. It returns a complete event record: title, description, date_time, address, phone, email, website, and the full url. Not every event will have all contact fields populated; availability depends on what the event organizer has provided.
Coverage and Freshness
All events are sourced from the gohawaii.com events and festivals directory, which is maintained by the Hawaii Tourism Authority. Results are sorted by date proximity, so the first page of search_events reflects the nearest upcoming events. The island filter accepts island names as strings (e.g. Oahu, Maui, Kauai, Hawaii Island) and maps to the corresponding section of the directory.
Pagination
Both page and per_page are optional integers on search_events. Use the total and per_page values from any response to determine the full page count for a given island or all-islands query. There is no cursor-based pagination; standard page-number iteration applies.
The gohawaii API is a managed, monitored endpoint for gohawaii.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when gohawaii.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 gohawaii.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 Hawaii travel itinerary tool that surfaces upcoming local festivals filtered by island and date.
- Aggregate hula, cultural, and music events by category field for a Hawaii culture guide app.
- Display event venue addresses and contact details for a local events map using the address field from get_event_details.
- Monitor new events added to gohawaii.com by polling search_events and comparing against a stored event list.
- Pull event websites and email contacts to compile a directory of Hawaii festival organizers.
- Feed event titles, dates, and cities into a calendar app covering all major Hawaiian Islands.
- Filter events by a specific island such as Maui or Kauai to power island-specific travel recommendation features.
| 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.