humanitix.com APIhumanitix.com ↗
Search Humanitix events by keyword, location, category, and price. Retrieve full event details including dates, venue, host info, and images via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/c0a44fe8-8642-4547-9058-27403e62ec34/search_events?limit=2&query=music&location=brisbane' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for events on Humanitix by keyword, location, and filters. Returns paginated results with event name, date, location, host name, pricing, and event URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed). |
| dates | string | Date filter. Accepted values: today, thisweek, thisweekend, nextweek, or empty string for all dates. |
| limit | integer | Maximum number of events to return. |
| price | string | Price filter. Accepted values: all, free, paid. |
| query | string | Search keyword for events. |
| category | string | Event category filter. Accepted values: music, foodAndDrink, sports, arts, or empty string for all categories. |
| location | string | Australian city name. Accepted values: sydney, melbourne, brisbane, adelaide, perth, canberra, hobart, darwin. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search query used",
"events": "array of event objects with event_name, date, end_date, location, host_name, description, price, slug, event_url, timezone, is_recurring",
"location": "string, the location filter used",
"total_returned": "integer, number of events returned in this response"
},
"sample": {
"data": {
"page": 0,
"query": "music",
"events": [
{
"date": "Sun Nov 09 2025 13:00:00 GMT+0000 (Coordinated Universal Time)",
"slug": "music-at-mcclelland-2026-subscription-tickets",
"price": "$220 - $440",
"end_date": "Sun Nov 15 2026 12:00:00 GMT+0000 (Coordinated Universal Time)",
"location": "McClelland, 390 McClelland Dr, Langwarrin VIC 3910, Australia",
"timezone": "Australia/Melbourne",
"event_url": "https://events.humanitix.com/music-at-mcclelland-2026-subscription-tickets",
"host_name": "Events at McClelland",
"event_name": "Music at McClelland - 2026 Subscription tickets",
"description": "",
"is_recurring": false
}
],
"location": "melbourne",
"total_returned": 3
},
"status": "success"
}
}About the humanitix.com API
The Humanitix API gives developers access to event discovery and detail data across Australia through 2 endpoints. search_events returns paginated results filtered by keyword, city, category, date range, and price tier, while get_event_details returns full event metadata including description, host background, venue address, and image URL for any event identified by its slug.
Search and Filter Events
The search_events endpoint accepts up to seven parameters. The query field narrows results by keyword, location restricts to one of eight Australian cities (sydney, melbourne, brisbane, adelaide, perth, canberra, hobart, darwin), and category filters to music, foodAndDrink, sports, or arts. The dates parameter accepts today, thisweek, thisweekend, or nextweek; passing an empty string returns all upcoming events. The price parameter accepts all, free, or paid. Results are paginated with 0-indexed page and a configurable limit. Each event object in the response includes event_name, date, end_date, location, host_name, description, price, slug, event_url, timezone, and is_rec.
Full Event Details
get_event_details takes a single required parameter — the slug from a search_events result — and returns a richer record. Fields include the full description, image_url, host_about (a narrative about the organiser), location with venue name and address, event_url, and the human-readable date string. This endpoint is the right choice when you need complete organiser context or a banner image for display.
Coverage and Scope
All location filtering is limited to Australian cities. The search_events response includes total_returned so callers can determine whether additional pages exist. The is_rec field on each event indicates whether the result is a recommended listing, which can be useful for ranking or deduplication in downstream applications.
- Build a local event calendar filtered by Australian city and date range using
search_eventslocationanddatesparams - Aggregate free community events by combining
price: freeandcategoryfilters fromsearch_events - Display event banner images in a mobile app using
image_urlfromget_event_details - Surface organiser background to users by pulling
host_aboutfromget_event_details - Generate event recommendation feeds by filtering on
is_recinsearch_eventsresults - Compare music and arts event density across cities by running
search_eventswith differentlocationandcategoryvalues - Pre-populate event detail pages by chaining
search_eventsslugs intoget_event_detailscalls
| 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 | 250 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 Humanitix have an official developer API?+
What does `get_event_details` return beyond what `search_events` already includes?+
get_event_details adds image_url, host_about, and a more complete description field. The search_events response includes a description field but it may be truncated; get_event_details returns the full text along with the canonical event_url and a human-readable date string formatted for display.Is event data available outside Australia?+
location parameter in search_events only accepts Australian city names, so geographic filtering is limited to Australia. Humanitix does operate in other markets. You can fork this API on Parse and revise it to add support for non-Australian locations if the underlying data is available.Does the API return ticket purchase links or seat availability?+
event_url, price, and event metadata, but does not expose ticket inventory counts, remaining seat availability, or direct purchase endpoints. You can fork it on Parse and revise it to add an endpoint covering ticket tier details if that data is accessible on the event page.How does pagination work in `search_events`?+
page parameter is 0-indexed, so the first page is page=0. The response includes total_returned, which reflects the count of events in the current response rather than the total across all pages. Use limit together with page to step through results, and stop paginating when total_returned is less than your limit value.