Events Search Request

task=eventsearch

The eventsearch API Request allow developers and applications to access the latest events published by local authorities on MapAlerter.com by using a number of filters and search parameters. Along with the compulsory parameters (eg API Key), there are also a series of parameters that are specific to the Events Search Query. 

Parameter Usage Example Required
council

Used to filter a local authority

  • Carlow
  • Limerick
  • Waterford
  • Wexford
  • Roscommon
&council=carlow No
searchterm You can filter your search to return certain keywords from the event's Title and Description &searchterm=party No
category

You can filter your search to return events from specific categories: Options include:

  • Culture
  • Historical
  • Library
  • Music
  • Sports
  • Theatre
&category=music No

Using the required parameters, the following makes up a typical Search API Request:

As you may notice, the various parameters are all optional. it is therefore possible to return the most recent 20 API results by simply omitting the three parameters above.