Upsight logo Back to top

Unique Visitors

Uniques


users/uniques

URL

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

Data Output Types

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

Required Parameters

ParameterValuesDescription
api_keyYour Upsight Analytics API key.
end_timeYYYYmmdd_HHMMThe end time element (day, week, month) in the time range being queried in the YYYYmmdd_HHMM format.
start_timeYYYYmmdd_HHMMThe start time element (day, week, month) in the time range being queried in the YYYYmmdd_HHMM format.
time_segment
  • week
  • hour
  • day
The frequency of data reporting. For example, a time segment by day will return the data on a daily basis between the start and end times specified. A time segment by hour will return the data on an hourly basis between the start and end times specified.

Optional Parameters

ParameterValuesDescription
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.

Code Example

Query URL:

http://query.kontagent.net/processed/v1/social/users/uniques/series.json/?start_time=20110605_0000&api_key=<API KEY>&time_segment=week&end_time=20110705_0000

Return:

[['2011-06-05', 43848],
['2011-06-12', 46236],
['2011-06-19', 44016],
['2011-06-26', 41401],
['2011-07-03', 48816]]

Uniques Rolling


users/uniques_rolling

URL

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

Data Output Types

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

Required Parameters

ParameterValuesDescription
api_keyYour Upsight Analytics API key.
end_timeYYYYmmdd_HHMMThe end time element (day, week, month) in the time range being queried in the YYYYmmdd_HHMM format.
start_timeYYYYmmdd_HHMMThe start time element (day, week, month) in the time range being queried in the YYYYmmdd_HHMM format.

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.
days_rolling
  • 7
  • 30
The number of days rolling.

Code Example

Query URL:

http://query.kontagent.net/processed/v1/social/users/uniques_rolling/series.json/?start_time=20110605_0000&api_key=<API KEY>&end_time=20110705_0000&days_rolling=30

Return:

[['2011-06-05', 96517],
['2011-06-06', 98633],
['2011-06-07', 100197],
['2011-06-08', 101216],
['2011-06-09', 102093],
['2011-06-10', 103254],
['2011-06-11', 104958],
['2011-06-12', 106619],
['2011-06-13', 108512],
['2011-06-14', 109310],
...