# PDOK Location API Features Search / Geocoding

Geocodeerservice om naar <i>features</i> te zoeken in één of meerdere collecties op basis van vrije tekst, zoals een adres of plaatsnaam.

## Search endpoint

The [search](https://api.pdok.nl/kadaster/location-api/v1/search) endpoint enables text-based geographic searching (geocoding) across multiple OGC API Features collections.
It returns GeoJSON feature collections containing the minimal information needed to display search results to the end user.
To access the complete details of a specific feature, follow the href link provided within its search result.
See the [OpenAPI spec](https://api.pdok.nl/kadaster/location-api/v1/api?=json) for more details.

The [HTML interface](https://api.pdok.nl/kadaster/location-api/v1/search?f=html) provides a practical example of how to interact with this API.

### Required Parameters

- The `q` param is required to specify the search term. Wildcards or boolean operators aren't allowed.
- One or more collections using deep object query parameters (e.g., `places[version]=1&addresses[version]=1`) need to be specified.
  A generic query like `?q=Amsterdam` will return **zero** results unless one or more collections are included.

### Optional Parameters

**CRS:** Use the `crs` query parameter to specify the coordinate reference system.

- Default: `http://www.opengis.net/def/crs/OGC/1.3/CRS84`
- `http://www.opengis.net/def/crs/EPSG/0/28992`
- `http://www.opengis.net/def/crs/EPSG/0/3857`
- `http://www.opengis.net/def/crs/EPSG/0/4258`


**Bounding Box:** Use the `bbox` query parameter to spatially filter results.
Use the `bbox-crs` param to specify the CRS of the provided `bbox` coordinates.