Menu
People API

Location

The API returns all people based on location in JSON format.

API response

Data elementDescription
BisnodeId The unique person id
x Longitude
y Latitude

API request parameters

ParameterDescription 
x Longitude value X
y Latitude value X
radius Radius max value is 5000. X

https://api-test.bisnode.fi/people/info/v2/location?x={x}&y={y}&radius={radius}

API endpoints

  • https://api-test.bisnode.fi/people/info/v2/location - test environment

In order to use the API you must have a valid api key on test environment and it must be sent in the request custom header element (named x-api-key). If the api key value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401). All API requests must be made over HTTPS.

cURL request example

curl 'https://api-test.bisnode.fi/people/info/v2/location?x=24.956794&y=60.194811&radius=50' -H 'x-api-key: 1234567890ABC'

API request and response example

GET https://api-test.bisnode.fi/people/info/v2/location?x=24.956794&y=60.194811&radius=100

Successful request and the API return results in JSON format.

{
    "coordinateSystem": "Wgs84",
    "count": 105,
    "errorMessage": null,
    "hits": [
        {
            "bisnodeId": "FI2101002012316",
            "x": 24.955964,
            "y": 60.194662
        },
        {
            "bisnodeId": "FI2101002069198",
            "x": 24.955964,
            "y": 60.194662
        },
        {
            "bisnodeId": "FI2101002136868",
            "x": 24.957108,
            "y": 60.194824
        },
        {
            "bisnodeId": "FI2101002244148",
            "x": 24.957108,
            "y": 60.194824
        },
        {
            "bisnodeId": "FI2101010876892",
            "x": 24.956936,
            "y": 60.194974
        }
    ]
}

Swagger documentation - read more »

Tulosta

Läs mer om våra tjänster på www.bisnode.com Bisnode