Skip to content
Naurt Docs

Batch Search

Tutorial

As discussed in the Quickstart, there are plenty of ways to access Naurt data. These examples will guide you through how you can perform multiple Naurt searches in a single request. Before continuing, make sure you have your free API key from the Naurt Dashboard.

You may have noticed by now that the queries field in each request is an array. Without changing endpoint, you’re able to use this array to search for up to 200 results in any search format you wish.

  1. Configure a POST request to the final-destination endpoint with the following headers.

    Terminal window
    https://api.naurt.net/final-destination/v2
    Authorization: <API-KEY-HERE>
    Content-Type: application/json

  2. Configure your JSON payload with any type of search you like.

    {
        "queries": [
            {
                "id": "c56dbebb-c7ab-ede2-a7ac-f84e57d1878d"
            },
            {
                "source_id": {
                    "os_udprn": "17594066"
                }
            },
            {
                "source_id": {
                    "os_uprn": "200001191298"
                }
            },
            {
                "location": {
                    "latitude": 50.542,
                    "longitude": 0.234
                }
            },
            {
                "address_string": "32 Thames St, Windsor SL4 1PS"
            },
            {
                "address_structured": {
                    "postalcode": "10013",
                    "street_name": "Broome Street",
                    "street_number": "489",
                    "city": "New York",
                },
                "additional_matches": true,
                "location": {
                    "latitude": 40.72,
                    "longitude": -74.0
                }
            }
        ]
    }

The response will then contain a best match for each of queries used to search.