Open Domesday
API
We now have a RESTful API, which supports geographical queries.
Data Formats
By default, information is returned as JSON. Append ?format= to a request to receive any of the following formats: json, xml, yaml, pickle, django.
API Version Number
The current version of the API is 1.0. If we change the API functions, we'll increase the version number and update the URLs accordingly, so you can still use the old version.
API Keys
We don't currently require an API key. Be aware this might change if for some reason we get lots of traffic.
Please get in touch with any feedback on the API.
PlacesNear: returns places within a radius (in km) of a given point, or places within a bounding box. Uses WGS84 coordinates. Examples:
http://domesdaymap.co.uk/api/1.0/placesnear?lat=52.5&lng=1.0&radius=10
http://domesdaymap.co.uk/api/1.0/placesnear?s=52.4&w=0.9&n=52.5&e=1.0
Place: returns one place by ID. The location field contains WGS84 coordinates, and
places usually have associated manors, hundreds, and counties. Example:
http://domesdaymap.co.uk/api/1.0/place/20086
Manor: returns one manor by ID. The manor is the central concept in our Domesday data:
roughly, it is "a reference to a single place in a single entry of Domesday". You'll find most
population, economic and livestock statistics here. Example:
http://domesdaymap.co.uk/api/1.0/manor/20385
Image: returns manors listed in each image. Query by county code and page number. Example:
http://domesdaymap.co.uk/api/1.0/image/sts/06
Hundred: returns all hundreds or one hundred by ID. Queries for an individual hundred
also return associated places.
http://domesdaymap.co.uk/api/1.0/hundred
http://domesdaymap.co.uk/api/1.0/hundred/forehoe
Area: returns all areas or one area by ID. Queries for an individual area
also return associated places.
http://domesdaymap.co.uk/api/1.0/area
http://domesdaymap.co.uk/api/1.0/area/isle-of-wight
County: returns all counties or one county by ID. Queries for an individual county
also return associated places.
http://domesdaymap.co.uk/api/1.0/county
http://domesdaymap.co.uk/api/1.0/county/nfk
Methods for owners/names coming soon (watch Twitter for updates).