allevents.in APIallevents.in ↗
Access event listings, details, venue data, and category filters from AllEvents.in across cities worldwide. 4 endpoints covering search, dates, and details.
curl -X GET 'https://api.parse.bot/scraper/9a478cf5-ac7c-432e-ae6f-e1b964932cd5/search_events?city=London&limit=8&category=entertainment' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for events in a city by category. Returns a list of events with basic info including name, dates, venue, and ticket availability.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City name to search events in (e.g. "London", "New York", "Tokyo"). |
| limit | integer | Maximum number of events to return. |
| category | string | Event category slug to filter by (e.g. "entertainment", "music", "art"). Use get_categories endpoint to discover available slugs for a city. |
{
"type": "object",
"fields": {
"city": "string, resolved city name",
"count": "integer, number of events returned",
"events": "array of event objects with event_id, name, start_time_display, end_time_display, location, venue, event_url, banner_url, organizer, tickets, categories, tags",
"country": "string, resolved country name"
},
"sample": {
"data": {
"city": "London",
"count": 16,
"events": [
{
"name": "Bruno Mars at Wembley Stadium",
"tags": [
"adventure"
],
"venue": {
"city": "London",
"state": "EN",
"street": "Royal Route, London, HA9 7EX",
"country": "United Kingdom",
"latitude": "51.556034",
"longitude": "-0.285558",
"full_address": "Wembley Stadium, Royal Route, London, HA9 7EX, United Kingdom"
},
"tickets": {
"ticket_url": "",
"has_tickets": false,
"ticket_currency": "GBP"
},
"event_id": "2400029485749316",
"location": "Wembley Stadium",
"event_url": "https://allevents.in/london/bruno-mars-at-wembley-stadium/2400029485749316",
"organizer": {
"name": "Vivid Events",
"org_id": "22309944"
},
"banner_url": "https://dyn-image.allevents.in/generate-image?v=4&title=Bruno+Mars+at+Wembley+Stadium&date=Sat%2C+18+Jul+at+05%3A00+pm&bg=2",
"categories": [
"trips-adventures"
],
"end_time_display": "Tue, 28 Jul at 05:00 pm",
"start_time_display": "Sat, 18 Jul at 05:00 pm"
}
],
"country": "United Kingdom"
},
"status": "success"
}
}About the allevents.in API
The AllEvents.in API gives developers access to event data across cities worldwide through 4 endpoints covering search, date-range filtering, detailed event records, and category discovery. The search_events endpoint returns event listings with names, start and end times, venue, location, ticket availability indicators, and banner images. Use get_event_details to retrieve structured fields including address, coordinates, ticket currency, and ISO-formatted dates for a specific event page.
Searching Events by City and Category
The search_events endpoint accepts a required city string and optional category and limit parameters. The response includes a resolved city and country name, a count of returned results, and an array of event objects. Each event object carries event_id, name, start_time_display, end_time_display, venue, location, event_url, banner_url, and organizer information. Category slugs (e.g. "music", "art", "entertainment") can be discovered via the get_categories endpoint, which returns a list of objects with slug, name, and count fields for the specified city.
Filtering Events by Date Range
The search_events_by_date endpoint works similarly to search_events but replaces the category filter with start_date and end_date inputs, both in "YYYY-MM-DD HH:MM" format. This makes it straightforward to build calendar-style views or narrow results to a weekend, a specific week, or a multi-week window. The response shape mirrors the category search: resolved city and country, a count, and the same event object array.
Retrieving Event Details
Passing a full event_url to get_event_details retrieves structured fields for a single event: name, venue, address, city, country, start_date, end_date (both ISO-formatted), latitude, longitude, currency, and ticket-related data when available. The endpoint notes that fields vary by event source — not every event will populate every field. Coordinates and address data are particularly useful for mapping integrations. Obtain valid event URLs from the event_url field returned by the search endpoints.
City Category Discovery
The get_categories endpoint is city-scoped. Passing a city name returns every category active in that city along with a count of available events per category and a total_rows integer. This is the intended way to populate a category picker before calling search_events, since valid slugs differ by city and some categories exist only in certain markets.
- Build a local event discovery feed filtered by category (e.g. 'music' or 'art') for a given city using
search_events. - Power a weekend-activity planner by querying
search_events_by_datewith Friday-to-Sunday date bounds. - Display a venue map by collecting
latitudeandlongitudefrom multipleget_event_detailscalls. - Aggregate event banner images and names for a city homepage using the
banner_urlandnamefields from search results. - Populate a category filter UI by calling
get_categorieson user-selected cities to list only active event types. - Track ticket currency and availability across cities by parsing the
currencyfield returned in event detail responses. - Sync event start and end times to a calendar application using the ISO
start_dateandend_datefields fromget_event_details.
| 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 AllEvents.in offer an official developer API?+
What does `get_event_details` return compared to the search endpoints?+
get_event_details adds structured fields available on the individual event page — ISO-formatted start and end dates, street address, latitude, longitude, and ticket currency code. Not all fields are populated for every event; availability depends on what the event listing includes.Are there limitations on which cities return results?+
get_categories endpoint is the practical way to check what's actually available in a given city before building queries against it — cities with sparse coverage may return few or no categories.Does the API support free-text keyword search for event names?+
search_events filters by city and category slug, and search_events_by_date filters by city and date range. You can fork this API on Parse and revise it to add a keyword search endpoint if your use case requires name-based filtering.Can I retrieve paginated results beyond the `limit` parameter?+
limit parameter to cap the number of results returned, but there is no pagination offset or cursor parameter currently available. You can fork this API on Parse and revise it to add offset or page-based pagination support.