Neighborhoods API

Automatically enrich any Dutch address with the correct neighborhood name. Below you'll read how to implement the Neighborhoods API.

Find the neighborhood of an address

With the Neighborhoods API you can easily find out which neighborhood an address is located in within the Netherlands. Such as:

Langestraat e.o.
Bezuidenhout-West
Grachtengordel-West
Museumkwartier

The neighborhood is the most detailed geographic level within a municipality. Each municipality is divided into districts, and each district consists of one or more neighborhoods. This classification comes from the CBS (Centraal Bureau voor de Statistiek). Neighborhood information is ideal for applications that require fine-grained geographic segmentation, analysis or audience-targeted services.

How it works

The Neighborhoods API is our standard Postcode API, with one extra attribute: neighborhood. By passing this attribute, you get the neighborhood name of the given address alongside the regular data such as street, city, municipality and province.

This means you don't have to learn or integrate a separate API - you use the same familiar Postcode API, but simply request attributes[]=neighborhood.

Real estate platforms - categorize homes by neighborhood to make search results clearer
Marketing and analysis - segment audiences by neighborhood for targeted campaigns
Municipal planning - analyze neighborhood data for policy, reporting or urban development
Logistics & delivery services - plan more efficient routes by adding neighborhood information to addresses

API request

GET https://api.nederlandpostcode.nl/v1/address?postcode=1015CN&number=10&addition=A&attributes[]=neighborhood

Parameter	Value	Description
`postcode`	1015CN	Postcode of the address
`number`	10	House number
`addition`	A	Optional addition to the house number
`attributes[]`	neighborhood	Specifies that you want to retrieve the neighborhood information

{
    "data": [
        {
            "postcode": "1015CN",
            "number": 10,
            "addition": "A",
            "street": "Keizersgracht",
            "city": "Amsterdam",
            "municipality": "Amsterdam",
            "province": "Noord-Holland",
            "country": "Nederland",
            "details": {
                "neighborhood": "Grachtengordel-Zuid"
            }
        }
    ]
}

Would you also like to know the district of an address in addition to the neighborhood? Then add attributes[]=district to your request. You can also request the coordinates of the address by passing attributes[]=coordinates.

Additional information

The neighborhood value gives the name of the neighborhood the address is located in.
If an address has no neighborhood, the value can be null. This applies to a very limited number of addresses in the Netherlands.
The Neighborhoods API is available in all subscriptions.

Would you like to enrich addresses at district level too? Then check the Districts API. You can find more information in the API documentation.