The API consists of a single endpoint, where you supply an IP address for which you would like to receive Digiseg’s Core Audiences.
The API is located here: https://ga.digiseg-collect.net/audiences/

To send requests to the endpoint, you must append the IP address to the URL and provide two headers – Authorization and Origin.
Using curl, it could look like this:
curl ‘https://ga.digiseg-collect.net/audiences/77.168.12.0’ –header ‘Authorization: API-KEY’ –header ‘Origin: DOMAIN’
Replace API-KEY and DOMAIN with the values specified in your activation e-mail. The Origin header is only required if using server-side scripts. When using the API in client-side scripts, the browser will automatically set Origin to the value of the visited website.

Responses when sending a request for an IP address, you will get a JSON formatted response, similar to this:
{
“status”: “success”,
“response”: {
“accommodationtype”: “2: House / Semi Detached”,
“building year”: “B: 1945 – 1989”,
“cars in the household”: “2 or more cars”,
“children in the household”: “C: households with 2 or more children”,
“education”: “A: Basic”,
“home ownership”: “Rent”,
“household income”: “B: Less affluent (Lowest 20-40%)”,
“lifecycle”: “1: Young singles and couples”,
“livingspace m2”: “< 80 m2”,
“neighborhood type”: “C: Suburban”,
“savings”: “1: No savings”,
“tech-level in household”: “B: Medium”
}}

If you request an IP address that we don’t have any valid data associated with, you will receive a no-data status, with an empty response, letting you know the data is not available – like this:
{
“status”: “no-data”,
“response”: “”
}
Along with the data, you will also receive an HTTP status code. 200 OK, or 404 Not Found.
In case of an error, you will receive a 500 Internal Server Error status code:
{
“status”: “error”,
“response”: “Internal Server Error”
}