Skip to the content

GetDemographics

Gets geo-demographic information from a postcode

Live Demo

To connect to this service you'll need to use one of these endpoints:

WSDL
https://webservices.data-8.co.uk/demographics.asmx
JSON
https://webservices.data-8.co.uk/Demographics/GetDemographics.json

Description

Finds geo-demographic profiling information from a postcode.

Supply a single postcode to retrieve a full demographic profile based on life stage (youngest - oldest) and wealth (poorest to richest). A name and full description of the profile that the supplied postcode falls in is also supplied.

Please note that profiles are created based on an aggregate of information available about each area, and there are always variations in the people living in each postcode which means that a particular individual might not always match the indicated profile.

Model Versions

The demographics model is refreshed annually. The details of the codes can vary slightly between editions of the model.

By default you will always be using the latest version of the model. However, if you need to remain on a specific version to keep consistency in your results, please ask your account manager. Major differences in the structure of the results between different versions are highlighted below.

Parameters

The following parameters can be supplied to this method

username

username

See the available authentication methods. If you are using username & password authentication, specify the username to authenticate as. If you are using API Key authentication and you are not using the JSON, Javascript or ADO APIs, use your API Key here with the prefix apikey-, e.g. apikey-ABCD-1234-EFGH-5678
password

password

If you are using username & password authentication, specify the password to use for authentication. Otherwise leave this blank.
postcode

postcode

The postcode to get the geo-demographic profile for

Results

This method returns an object containing the following fields:

Status

Status

Indicates whether the method call was successful, or if some error occurred. If the Success field is true, the other results described below can be used to get the results of the method. If Success is false, some error occurred in calling the method, such as the authentication failed or the account is out of credits. The details of the error can be obtained from the ErrorMessage field, and any other results should be ignored
SonarCode

SonarCode

The unique code for the profile that the postcode falls in to

Title

Title

A human-readable name for the profile

PercentageOfHouseholds

PercentageOfHouseholds

The percentage of households in the UK that fall into this same profile

Lifestage

Lifestage

A rating from A to F to indicate the life stage of people living in this area. A indicates Young Singles and F indicates Retired

WealthQuartile

WealthQuartile

An indicator of the affluence of people living in this area. 1 indicates Affluent and 4 indicates Struggling

WealthRanking

WealthRanking

Latest Version

A more detailed indicator of the wealth of people living in this postcode. While the WealthQuartile value is calculated at census output area (average of 11 postcodes), this value is calculated at individual postcode level. Postcodes are ranked in wealth between 1 (wealthiest) and 20 (poorest).

Because of the difference in area across which the WealthQuartile and WealthRanking values are calculated, there can be discrepancies between the two. Where there are wealthy and poorer areas close together, the WealthQuartile is essentially an average of the different WealthRanking values within that area, so it is possible to have a poor (ranking 20) postcode within a generally wealthy (quartile 1) area.

2016 Version

An indicator of the wealth of people living in this postcode. 1 indicates the wealthiest people and 100 indicates the poorest

Description

Description

A human-readable description of the type of area that the postcode tends to cover

Live Demo

postcode
options No options are currently supported by this method

Sample Code

Start a Free 30 Day Trial Today

Start a free trial today