Welcome to Version 1 of the MapAlerter.com API. The aim of our API is to allow developers to access our alert data through their own applications such as Mobille Apps, widgets and many more. We provide our data as XML, JSON and JSONP to reflect our belief in Open Data. Data is retrieved by sending a HTTP(S) GET request to a URL with a required API key, the response format, a task parameter, and query parameter(s).

The API is delivered as a series of GET requests with various parameters allowing you to only access the information that interests you and your audience. For example, you can refine our alert data so that it will only include results from Wexford County Council. Similarly you can refine results to only include Flood Alerts and Severe Weather Warnings if you are interested in consuming our data for a severe weather alert system.

All alerts posted on MapAlerter include geographic information. We are happy to share our GIS boundaries and layer information in a structured manner such as a delimited list of coordinates. For ease of use we also post the number of coordinates per alert boundary.

Our documentation is listed below and is straightforward to follow. We use a neat coloured structure when we include examples of how the API in action, for example:

This is an example of an XML response:
<mapalert><entry>
<id>661</id>
<title>Water Interruption Notice - Thurs 30th Aug 2012</title>
<created_by>2703</created_by>
<SMS>Water Interruption Notice 3pm-6pm Thurs 30th Aug 2012 Askea Area, Carlow</SMS>
<category>water</category>
<latitude>52.8362024000</latitude>
<longitude>-6.9091159000</longitude>
<coordstring>-6.9091,52.8362024;-6.90917,52.83561;-6.90934,52.83501;</coordstring>
<coordcount>3</coordcount>
<Day>29</Day>
<Month>8</Month>
<Year>2012</Year>
<Hour>15</Hour>
<Minute>21</Minute>
<bitly>http://bit.ly/N3KQFx</bitly>
</entry>
</mapalert>

If you have any feedback on our API then please let us know. We are happy to extend our API to suit the needs of the developer community in any way we can. There is an API limit request that is currently set at 25000 requests per day. You must register for a free API key in order to use our API. The API is currently in Beta and is subject to some changes and improvements over time. All registered API account holders will be notified if anything changes with the request structures/responses.