Phangan APIphangan.events ↗
Access upcoming events, parties, and festivals on Koh Phangan via two endpoints. Filter by keyword or event type, paginate results, and fetch full event details.
What is the Phangan API?
The phangan.events API provides structured data from Koh Phangan's event listings across 2 endpoints, returning fields like event title, start and end datetimes, location name, event type, image URL, and full description. The list_events endpoint lets you search and filter upcoming events by keyword or type, while get_event retrieves complete details for a single event by its numeric ID.
curl -X GET 'https://api.parse.bot/scraper/e1b14f92-a3da-4706-9486-84cecc8e6d1a/list_events?search=party&event_type=party' \ -H 'X-API-Key: $PARSE_API_KEY'
List upcoming events on Koh Phangan with optional keyword search, event type filter, and pagination. Results are ordered by most recently published first. Each request makes one upstream call; use page/per_page to tile the result space.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| search | string | Free-text keyword search across event titles and content (e.g. 'jungle', 'waterfall', 'techno'). |
| per_page | integer | Number of events per page, between 1 and 100. |
| event_type | string | Filter by event type. Accepts a known slug (art, brunch, community, day_party, ecstatic_dance, festival, kids, live_music, market, movie, party, practice, sport, standup, theatre, wellness, workshop, yoga) or a numeric taxonomy ID. Omitting returns all types. |
{
"type": "object",
"fields": {
"page": "current page number",
"events": "array of event objects with id, title, slug, description, link, start/end datetimes, location, type, image, and status",
"per_page": "number of results per page"
},
"sample": {
"page": 1,
"events": [
{
"id": 82714,
"link": "https://phangan.events/events/waterfall-festival-10/",
"slug": "waterfall-festival-10",
"title": "Waterfall Festival",
"status": "scheduled",
"end_ampm": "am",
"end_hour": "6",
"featured": true,
"timezone": "Asia/Bangkok",
"image_url": "https://phangan.events/wp-content/uploads/2026/08/file_4035.jpg",
"end_minute": null,
"start_ampm": "pm",
"start_hour": "9",
"description": "Waterfall Festival Koh Phangan | August 30, 2026...",
"end_datetime": "2026-08-30T23:00:00+00:00",
"location_ids": [
987
],
"start_minute": null,
"location_name": "WATERFALL FESTIVAL",
"event_type_ids": [
54,
24
],
"start_datetime": "2026-08-30T14:00:00+00:00",
"event_type_names": [
"Festivals",
"Parties"
]
}
],
"per_page": 3
}
}About the Phangan API
Listing and Filtering Events
The list_events endpoint returns an array of event objects ordered by most recently published first. You can control pagination with page (1-based) and per_page (1–100 results). Each event object includes id, title, slug, description, link, start and end datetimes, location, type, image, and status. The optional search parameter runs a free-text match against event titles and content — useful for queries like jungle, techno, or waterfall. The event_type parameter accepts a slug such as festival, day_party, ecstatic_dance, brunch, or community to narrow results to a specific category.
Fetching a Single Event
The get_event endpoint takes a numeric event_id (obtained from list_events) and returns the full record for that event. The response includes id, title, slug, link, status, timezone (e.g. Asia/Bangkok), image_url, description (plain text), end_datetime (ISO 8601 in UTC), and location_name. This is the right endpoint when you need the complete description or precise timing for a known event.
Coverage and Scope
All events are geographically scoped to Koh Phangan, Thailand. The data covers the range of event types that phangan.events publishes — parties, festivals, art events, kids activities, brunch events, and community gatherings among others. Events are ordered by publication date, not by event start date, so paginating from page 1 surfaces the newest listings first.
The Phangan API is a managed, monitored endpoint for phangan.events — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when phangan.events 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 phangan.events 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 Koh Phangan trip planner that surfaces upcoming festivals and parties by arrival date range
- Create a daily digest of new events filtered by type (e.g.
ecstatic_danceorfestival) for newsletter delivery - Power a venue-specific event widget by filtering
list_eventsresults bylocation_name - Aggregate event image URLs and titles for a visual calendar or social media post scheduler
- Query
list_eventswith keyword search (e.g. 'techno') to build a genre-specific event feed for electronic music fans - Monitor event
statusfield changes to notify users when a scheduled event is updated or cancelled - Enrich a travel app itinerary by fetching full event descriptions and datetimes via
get_event
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does phangan.events offer an official developer API?+
What does `list_events` return and how granular is event type filtering?+
events array includes the event's id, title, slug, description, link, start and end datetimes, location, type, image, and status. The event_type parameter accepts slugs including art, brunch, community, day_party, ecstatic_dance, festival, kids, and others. You can only filter by one type slug per request.Does the API return events sorted by start date?+
list_events results are ordered by publication date (most recently published first), not by event start datetime. If you need chronological ordering by start time, you will need to sort the results client-side after fetching them.Does the API cover past events or only upcoming ones?+
list_events endpoint is scoped to upcoming events on phangan.events. Past event archives are not currently exposed. You can fork this API on Parse and revise it to add a historical events endpoint if that data is available on the source site.Can I filter events by a specific venue or exact date range?+
event_type and free-text search, but there is no dedicated parameter for venue name or date range filtering. You can fork this API on Parse and revise it to add date-range or location-based filter parameters.