Jump to the following:

Open Names Search API

A keyword or search expression that conforms to the advanced search syntax. Searches can also be limited to one of the supported fields. E.g:

"The Vale of Glamorgan"
vale -glamorgan
easting:[373000 TO 374000]
hasAreaCode:WMC

Choose a response format, RSS 2.0, Atom 1.0, or JSON

Read more about the Supported Response Formats

The max parameter specifies the maximum number of results to return. In the query. Can by any numeric value. A list is provided for convenience.

The offset parameter specifies the beginning of the result set to display. This can be used to page through the results. E.g:

...&max=10&offset=10

For spatial queries the lat parameter specifies the latitude of the starting point. The lon parameter must also be provided.

For spatial queries the lon parameter specifies the longitude of the starting point. The lat parameter must also be provided.

For spatial queries the easting parameter specifies the easting of the starting point. The northing parameter must also be provided.

For spatial queries the northing parameter specifies the northing of the starting point. The easting parameter must also be provided.

For spatial queries the r parameter specifies a distance (in kilometres) from the starting point. Locations within this radius will be included in the results.

The format of the results. If not specified, defaults to json.