Upsight logo Back to top

User Distribution

Gender Distribution


users/gender_distribution

URL

http://query.kontagent.net/processed/v1/social/users/gender_distribution/<data_type>.<data_format>/?api_key=<API KEY>&<other parameters>

Data Output Types

ParameterValuesDescription
data_typelistThe output data type.
data_format
  • json
The format of the output data.

Required Parameters

ParameterValuesDescription
api_keyYour Upsight Analytics API key.

Optional Parameters

ParameterValuesDescription
age
  • unknown
  • 0-12
  • 13-17
  • 18-24
  • 25-29
  • 30-34
  • 35-39
  • 40-49
  • 50-64
  • 65+

The age group the user falls into.

countryPlease see the ISO-3166-1 alpha-2 list.

The country code of the country in which the user is located. The country code must be in upper case format and conform to the ISO-3166-1 alpha-2 standard. If not sent, it will be based on the user's IP.

Note! The Facebook locales ar_AR and es_LA do not follow the ISO standard. Facebook uses them to denote umbrella locales for Arabic and Spanish speaking regions. If you send the last two characters of these locales to Upsight Analytics, they will map to Argentina and Laos. As a best practice, if you see these locales, do not pass the country code. For additional information on Facebook locales, click here.

friends
  • unknown
  • 0-10
  • 11-20
  • 21-40
  • 41-60
  • 61-80
  • 81-125
  • 126-250
  • 250+
The number of friends a user has. Defined by a friend range.
gender
  • female
  • male
  • unknown
The user gender.

Code Example

Query URL:

http://query.kontagent.net/processed/v1/social/users/gender_distribution/list.json/?api_key=<API KEY>

Return:

[['App', 1],
['Female', 23584],
['Male', 459696],
['Unknown', 45938]]

Age Distribution


users/age_distribution

URL

http://query.kontagent.net/processed/v1/social/users/age_distribution/<data_type>.<data_format>/?api_key=<API KEY>&<other parameters>

Data Output Types

ParameterValuesDescription
data_typelistThe output data type.
data_format
  • json
The format of the output data.

Required Parameters

ParameterValuesDescription
api_keyYour Upsight Analytics API key.

Optional Parameters

ParameterValuesDescription
age
  • unknown
  • 0-12
  • 13-17
  • 18-24
  • 25-29
  • 30-34
  • 35-39
  • 40-49
  • 50-64
  • 65+

The age group the user falls into.

countryPlease see the ISO-3166-1 alpha-2 list.

The country code of the country in which the user is located. The country code must be in upper case format and conform to the ISO-3166-1 alpha-2 standard. If not sent, it will be based on the user's IP.

Note! The Facebook locales ar_AR and es_LA do not follow the ISO standard. Facebook uses them to denote umbrella locales for Arabic and Spanish speaking regions. If you send the last two characters of these locales to Upsight Analytics, they will map to Argentina and Laos. As a best practice, if you see these locales, do not pass the country code. For additional information on Facebook locales, click here.

friends
  • unknown
  • 0-10
  • 11-20
  • 21-40
  • 41-60
  • 61-80
  • 81-125
  • 126-250
  • 250+
The number of friends a user has. Defined by a friend range.
gender
  • female
  • male
  • unknown
The user gender.

Code Example

Query URL:

http://query.kontagent.net/processed/v1/social/users/age_distribution/list.json/?api_key=<API KEY>

Return:

[['0 - 12', 35609],
['13 - 17', 202983],
['18 - 24', 153281],
['25 - 29', 38235],
['30 - 34', 25781],
['35 - 39', 11536],
['40 - 49', 9719],
['50 - 64', 2938],
['65+', 3156],
['None', 1],
['Unknown', 45980]]

Friends Distribution


users/friends_distribution

URL

http://query.kontagent.net/processed/v1/social/users/friends_distribution/<data_type>.<data_format>/?api_key=<API KEY>&<other parameters>

Data Output Types

ParameterValuesDescription
data_typelistThe output data type.
data_format
  • json
The format of the output data.

Required Parameters

ParameterValuesDescription
api_keyYour Upsight Analytics API key.

Optional Parameters

ParameterValuesDescription
age
  • unknown
  • 0-12
  • 13-17
  • 18-24
  • 25-29
  • 30-34
  • 35-39
  • 40-49
  • 50-64
  • 65+

The age group the user falls into.

countryPlease see the ISO-3166-1 alpha-2 list.

The country code of the country in which the user is located. The country code must be in upper case format and conform to the ISO-3166-1 alpha-2 standard. If not sent, it will be based on the user's IP.

Note! The Facebook locales ar_AR and es_LA do not follow the ISO standard. Facebook uses them to denote umbrella locales for Arabic and Spanish speaking regions. If you send the last two characters of these locales to Upsight Analytics, they will map to Argentina and Laos. As a best practice, if you see these locales, do not pass the country code. For additional information on Facebook locales, click here.

friends
  • unknown
  • 0-10
  • 11-20
  • 21-40
  • 41-60
  • 61-80
  • 81-125
  • 126-250
  • 250+
The number of friends a user has. Defined by a friend range.
gender
  • female
  • male
  • unknown
The user gender.

Code Example

Query URL:

http://query.kontagent.net/processed/v1/social/users/friends_distribution/list.json/?api_key=<API KEY>

Return:

[['0 - 10', 17577],
['11 - 20', 13162],
['126 - 250', 119992],
['21 - 40', 28785],
['250+', 190123],
['41 - 60', 28401],
['61 - 80', 26792],
['81 - 125', 55068],
['None', 1],
['Unknown', 49318]]

Country Distribution


users/country_distribution

URL

http://query.kontagent.net/processed/v1/social/users/country_distribution/<data_type>.<data_format>/?api_key=<API KEY>&<other parameters>

Data Output Types

ParameterValuesDescription
data_typelistThe output data type.
data_format
  • json
The format of the output data.

Required Parameters

ParameterValuesDescription
api_keyYour Upsight Analytics API key.

Optional Parameters

ParameterValuesDescription
age
  • unknown
  • 0-12
  • 13-17
  • 18-24
  • 25-29
  • 30-34
  • 35-39
  • 40-49
  • 50-64
  • 65+

The age group the user falls into.

countryPlease see the ISO-3166-1 alpha-2 list.

The country code of the country in which the user is located. The country code must be in upper case format and conform to the ISO-3166-1 alpha-2 standard. If not sent, it will be based on the user's IP.

Note! The Facebook locales ar_AR and es_LA do not follow the ISO standard. Facebook uses them to denote umbrella locales for Arabic and Spanish speaking regions. If you send the last two characters of these locales to Upsight Analytics, they will map to Argentina and Laos. As a best practice, if you see these locales, do not pass the country code. For additional information on Facebook locales, click here.

friends
  • unknown
  • 0-10
  • 11-20
  • 21-40
  • 41-60
  • 61-80
  • 81-125
  • 126-250
  • 250+
The number of friends a user has. Defined by a friend range.
gender
  • female
  • male
  • unknown
The user gender.
group_by
  • location:country
  • location:country_abbreviation
  • location:continent
  • location:continent_abbreviation
  • demographic:gender
  • demographic:gender_abbreviation
  • demographic:age_range
The location or demographic group.
country_display_value
  • abbreviation
  • iso-3166
  • iso3166
  • name
How you would like the country name be displayed in the output data.

Code Example

Query URL:

http://query.kontagent.net/processed/v1/social/users/country_distribution/list.json/?api_key=<API KEY>

Return:

[['Afghanistan', 13],
['Albania', 1487],
['Algeria', 966],
['Andorra', 9],
['Angola', 51],
['Anguilla', 3],
['Antigua and Barbuda', 24],
['App', 1],
['Argentina', 9051],
['Armenia', 40],
...

Continent Distribution


users/continent_distribution

URL

http://query.kontagent.net/processed/v1/social/users/continent_distribution/<data_type>.<data_format>/?api_key=<API KEY>&<other parameters>

Data Output Types

ParameterValuesDescription
data_typelistThe output data type.
data_format
  • json
The format of the output data.

Required Parameters

ParameterValuesDescription
api_keyYour Upsight Analytics API key.

Optional Parameters

ParameterValuesDescription
age
  • unknown
  • 0-12
  • 13-17
  • 18-24
  • 25-29
  • 30-34
  • 35-39
  • 40-49
  • 50-64
  • 65+

The age group the user falls into.

countryPlease see the ISO-3166-1 alpha-2 list.

The country code of the country in which the user is located. The country code must be in upper case format and conform to the ISO-3166-1 alpha-2 standard. If not sent, it will be based on the user's IP.

Note! The Facebook locales ar_AR and es_LA do not follow the ISO standard. Facebook uses them to denote umbrella locales for Arabic and Spanish speaking regions. If you send the last two characters of these locales to Upsight Analytics, they will map to Argentina and Laos. As a best practice, if you see these locales, do not pass the country code. For additional information on Facebook locales, click here.

friends
  • unknown
  • 0-10
  • 11-20
  • 21-40
  • 41-60
  • 61-80
  • 81-125
  • 126-250
  • 250+
The number of friends a user has. Defined by a friend range.
gender
  • female
  • male
  • unknown
The user gender.

Code Example

Query URL:

http://query.kontagent.net/processed/v1/social/users/continent_distribution/list.json/?api_key=<API KEY>

Return:

[['Africa', 7349],
['App', 1],
['Asia', 121622],
['Europe', 281043],
['North America', 39500],
['Oceania', 6818],
['South America', 45058],
['Unknown', 27828]]