API is a RESTful service that provides XML output for various types of historical events. It's very much in beta and was intended for our own applications. It'll be made more scalable/reliable in the near future. At this stage, only XML data is available.
The database and industry specific areas are growing on a daily basis. If you have specific needs, please let us know.
Because the API is free and doesn't require registration, we've mitaged the potential for abuse by rate limiting unreasonable requests and we truncate various types of output. If you're building an application and require uninterrupted access, let us know and we'll whitelist you. Registered users get full and complete access; this includes the ability to build queries by any parameter - including keywords.
The XML URL is as follows:
The URL structure is as follows:
All queries begin with:
- query aviation
history. Must be lower case.
- September (two digits).
- 26th day of the month (always two digits).
- Page 1. No leading zero.
- Number of results per page (max 15... for now).
For the moment, you're limited to aviation
queries. More are
available and will be made public soon.
Output looks like this:
Note that the output includes the number of pages, the number of total results, the result limit (max 15 at this stage) and the page number. The status message of
indicates a successful response.
At times, sometimes it's necessary to generate a single random item for inclusion on a webpage or blog. To that end, use the following:
Results are cached locally for about 10 minutes. It's expected that you would also cache the results for up to 15 minutes to avoid any rate-limiting. If you're using any of our code, we provide that functionality by default.
Note, again, the 200 response code. If you don't receive this, it's best to keep your locally cached copy until new information becomes available.
Random Output by Date
Random output doesn't take date into consideration; it literally picks anything from the data. To refine your random result by date, use the following format:
is the month and 24
is the date. Numbers must include the leading '0'. Of course, you'll need to replace event
with whatever data source you're querying.
Limited RSS feeds are available from the main page. They can be consumed via any number of RSS readers or consumed directly into a WordPress (or other) blog via an array of available widgets and tools.
These feeds, however, are based on a timezone on the Eastern State of Australia. For feeds in your own timezone, use the following format:
... where 10
is the month (October) and 23
is the date. Of course, replace aviation
with whatever it is you're searching (again, at this stage, only aviation, birth, death or event).
There are various errors that might be generated. Generally speaking, anything other than a 200
response is bad. Rate limiting also applies (code 420
Despite the fact we're using this information on a number of our own sites, the prime motivation was to make aviation historical information available. If you're an aviation person and need help with implementation, get in touch with us and we'll do our best to help. WordPress and other code will be available on our Flight blog
It's in BETA
The service is considered in a very early
stage of development. If you have any ideas or encounter any errors, please let us know.
By using the Hiztory
provide attribution with a link to