For Developers

The Nearabouts API

Read-only access to verified, curated data on independent businesses across the UK. Ten verticals, 80+ regions, updated continuously.

Authentication

All requests require an API key passed via the x-api-key header or api_key query parameter.

curl https://www.nearabouts.co.uk/api/v1/venues \
  -H "x-api-key: atlas_pk_your_key_here"

Rate Limits

Free

1,000 requests/day

Partner

10,000 requests/day

Endpoints

GET/api/v1/venues

List all verified venues. Filter by vertical, region, state.

Params: verticalregionstatelimit (max 200)offset

GET/api/v1/venues/{id}

Get a single venue by ID.

GET/api/v1/regions

List all mapped regions. Filter by state.

Params: state

GET/api/v1/regions/{slug}/venues

List all venues in a specific region. Filter by vertical.

Params: verticallimit (max 500)offset

Response Format

{
  "data": [
    {
      "id": "uuid",
      "name": "Camel Valley Vineyard",
      "slug": "camel-valley-vineyard",
      "vertical": "cellar",
      "category": "vineyard",
      "description": "...",
      "suburb": "Nanstallon",
      "state": "ENG",
      "region": "Cornwall",
      "lat": 50.462,
      "lng": -4.792,
      "is_claimed": true,
      "is_featured": true
    }
  ],
  "meta": {
    "total": 847,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

Use Cases

Tourism app developers

Integrate verified independent venue data into your travel or discovery app.

Regional council GIS

Pull independent business data for spatial analysis and regional planning.

Travel writers

Build custom itineraries from verified listing data across ten categories.

Researchers

Study independent business distribution, regional economic patterns, and cultural geography across the UK.

Data Policy

The API does not expose PII, contact details of unclaimed venues, or internal scoring data. All data returned is already publicly visible on the Nearabouts network websites.

Attribution is required: include "Data from Nearabouts" with a link to nearabouts.co.uk in any public-facing use of the data.

Get an API key

API keys are issued on request. Tell us what you are building and we will get you set up.

Request API access