Digiseg API guide

To get started using the Digiseg Audience API, you need an API-Key. If you don’t have it already can be requested here
It is free of charge for a limited number of requests. The service is limited to a maximum of 100 requests per second. Please contact support if you need a higher limit. 

Requests

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”
}

Taxonomy

The API provides Digiseg’s Core Audiences. See below for a complete list. See the Audiences page for more information and reach numbers.

AccommodationType
• 1: Apartment
• 2: House / Semi Detached

Savings
• 1: No savings
• 2: Smaller savings
• 3: Larger savings (Top 20%)

Lifecycle
• 1: Young singles and couples
• 2: Young couples with children
• 3: Families with school children
• 4: Older families and matured couples
• 5: Pensioners

Cars in the household
• 0 Car
• 1 Car
• 2 or more cars

Children in the household
• A: Households without children
• B: Households with 1 child
• C: households with 2 or more children

Education
• A: Basic
• B: Medium
• C: Higher

Neighborhood Type
• A: Countryside
• B: Village
• C: Suburban
• D: City

Household Income
• A: Poorer households (Lowest 20%)
• B: Less affluent (Lowest 20-40%)
• C: Comfortable households (Middle 40-60%)
• D: Prosperous households (Highest 60-80%)
• E: Wealthy households (Top 20%)

Home Ownership
• Rent
• Own

Building Year
• A: Before 1945
• B: 1945 – 1995
• C: From 1995 till today

Livingspace M2
• < 80 m2
• 80 – 119 m2
• 120+ m2

Tech-Level in Household
• A: High
• B: Medium
• C: Low

Business
• Small
• Medium
• Large

Read our blog

Boost engagement – Increase viewability – Drive conversions – Deliver ROAS.

Our audience experts
will get you started

Book an intro meeting

Our Xandr Specialist is waiting for you

We're ready to find the audience just for your campaign

Let us know what platform is missing

Our integrations and platforms are always expanding. So please let us know if you can’t find the integration you are looking for