Humanitix APIhumanitix.com ↗
Search Humanitix events by city, category, date, and price. Retrieve full event details including venue, description, host bio, and image via 2 endpoints.
What is the Humanitix API?
The Humanitix API provides 2 endpoints to search and retrieve event data from Humanitix, one of Australia's largest ticketing platforms. The search_events endpoint returns paginated event summaries — up to 32 per page — filtered by Australian city, category, date range, and price type. The get_event_details endpoint delivers the full event record including venue address, rich-text description, host biography, canonical URL, and hero image for any event slug returned by search.
curl -X GET 'https://api.parse.bot/scraper/c0a44fe8-8642-4547-9058-27403e62ec34/search_events?page=0&dates=all&limit=32&price=all&query=music&category=all&location=sydney' \ -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 humanitix-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.
from parse_apis.humanitix_events_api import Humanitix, EventSummary, Event, Location, Category, DateFilter, PriceFilter
client = Humanitix()
# Search for music events in Melbourne
for event in client.eventsummaries.search(
query="music",
location=Location.MELBOURNE,
category=Category.MUSIC,
dates=DateFilter.THIS_WEEK,
price=PriceFilter.ALL,
limit=5,
):
print(event.event_name, event.date, event.location, event.price)
# Get full details for an event
details = event.details()
print(details.event_name, details.description, details.host_about, details.image_url)
Full-text search over Humanitix events in Australian cities. Filters by category, date range, and price type. Returns paginated event summaries with name, date, location, host, pricing, and slug for drill-down. Each page returns up to 32 events; advance via the page param.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed). |
| dates | string | Date filter. Accepted values: all, today, thisweek, thisweekend, nextweek. |
| limit | integer | Maximum number of events to return per request. |
| price | string | Price filter. Accepted values: all, free, paid. |
| query | string | Search keyword for events. |
| category | string | Event category filter. Accepted values: all, music, foodAndDrink, sports, arts. |
| 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 summary objects",
"location": "string, the location filter used",
"total_returned": "integer, number of events returned in this response"
},
"sample": {
"data": {
"page": 0,
"query": "music",
"events": [
{
"date": "Fri Oct 23 2026 08:00:00 GMT+0000 (Coordinated Universal Time)",
"slug": "bitd2025-accord-fri",
"price": "$49",
"end_date": "Fri Oct 23 2026 09:15:00 GMT+0000 (Coordinated Universal Time)",
"location": "St. James Church Crypt, 173 King St, Sydney NSW 2000, Australia",
"timezone": "Australia/Sydney",
"event_url": "https://events.humanitix.com/bitd2025-accord-fri",
"host_name": "Bach in the Dark",
"event_name": "Bach in the Dark - music for cello and accordion",
"description": "",
"is_recurring": false
}
],
"location": "sydney",
"total_returned": 3
},
"status": "success"
}
}About the Humanitix API
Searching Events
The search_events endpoint accepts a free-text query alongside structured filters: location (one of eight Australian cities including sydney, melbourne, and brisbane), category (music, foodAndDrink, sports, or arts), dates (today, thisweek, thisweekend, nextweek, or all), and price (free or paid). Results are paginated — each response includes page, total_returned, and an events array of summary objects carrying the event name, date, location, host, pricing indicators, and the slug field used for drill-down. Use the page param (0-indexed) to advance through result sets.
Event Detail Records
Passing any slug from search_events to get_event_details returns a single-event object with eight fields: event_name, human-readable date, location (venue name and street address), description (full rich-text body), host_about (organiser biography), event_url (canonical Humanitix link), image_url (hero image), and the slug itself. This makes it straightforward to build event listings that show structured venue data and organiser context alongside the formatted date string.
Coverage and Scope
Coverage is limited to events listed on the Australian Humanitix platform (humanitix.com/au). All eight city filters correspond to Australian capitals. Category filtering supports four values: music, foodAndDrink, sports, and arts. Events without a matching slug in the search response cannot be retrieved via get_event_details; the slug is the only lookup key the detail endpoint accepts.
The Humanitix API is a managed, monitored endpoint for humanitix.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when humanitix.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 humanitix.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 city-specific event guide aggregating Humanitix listings filtered by location and category
- Generate a weekly email digest of free events in a target Australian city using the price=free and dates=thisweek filters
- Populate a calendar app with structured venue addresses and human-readable dates from get_event_details
- Monitor new music or arts events in multiple cities by querying search_events with category and dates filters
- Display host biographies alongside event descriptions for editorial event-discovery content
- Compare event volume across Australian cities by paginating search_events results per location
- Enrich an existing ticketing dataset with hero images and canonical URLs via the image_url and event_url fields
| 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.