get_demographics_hh_income

Gets the ratio of viewers bucketed by annual income ranges for a specific tracker or publisher ID.

Explorer

Explore this method

Request URL

http://api.tubemogul.com/api/v3/

HTTP method

GET

Arguments

scope (string)
The scope of the method being called. Valid values are tracker or publisher.
id (string)
The ID corresponding to the scope of the report.
start (string)
The start date for the report. Format is YYYY-MM-DD.
end (string)
The end date for the report. Format is YYYY-MM-DD.
site_id (string) — Optional
The ID for your site. This is required for publisher-scoped queries but not for trackers. Contact us if you do not know your site_id.
interval (string) — Optional
Determines the granularity of list values in the detailed response list. Valid values include perday or none. A value of none will omit the detail list. Defaults to none.

Response Parameters

pct_0_to_20K (integer)
The percentage of viewers who earn less than $20,000 per year.
pct_20K_to_30K (integer)
The percentage of viewers who earn between $20,000 and $30,000 per year. (inclusive)
pct_30K_to_40K (integer)
The percentage of viewers who earn between $30,000 and $40,000 per year. (inclusive)
pct_40K_to_50K (integer)
The percentage of viewers who earn between $40,000 and $50,000 per year. (inclusive)
pct_50K_to_60K (integer)
The percentage of viewers who earn between $50,000 and $60,000 per year. (inclusive)
pct_60K_to_75K (integer)
The percentage of viewers who earn between $60,000 and $75,000 per year. (inclusive)
pct_75K_to_100K (integer)
The percentage of viewers who earn between $75,000 and $100,000 per year. (inclusive)
pct_100K_to_125K (integer)
The percentage of viewers who earn between $100,000 and $125,000 per year. (inclusive)
pct_125K_to_150K (integer)
The percentage of viewers who earn between $125,000 and $150,000 per year. (inclusive)
pct_over_150K (integer)
The percentage of viewers who earn more than $150,000 per year.
details (list)
A list of percentage buckets over time with the following parameters: date, pct_0_to_20K, pct_20K_to_30K, pct_30K_to_40K, pct_40K_to_50K, pct_50K_to_60K, pct_60K_to_75K, pct_75K_to_100K, pct_100K_to_125K, pct_125K_to_150K, and pct_over_150K. The entries are scoped based on the arguments provided in the request.

Example Response

http://api.tubemogul.com/api/v3?date=1230109922&user_id=123456
&scope=tracker&id=TD-PEX-Y83&method=get_demographics_hh_income&interval=perday
&start=2010-11-15&end=2010-11-20&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e4

<response name="get_demographics_hh_income" status="ok">
	<pct_0_to_20K>14.35</pct_0_to_20K>
	<pct_20_to_30K>10.54</pct_20_to_30K>
	<pct_30_to_40K>8.98</pct_30_to_40K>
	<pct_40_to_50K>7.39</pct_40_to_50K>
	<pct_50_to_60K>8.1</pct_50_to_60K>
	<pct_60_to_75K>13.25</pct_60_to_75K>
	<pct_75_to_100K>15.66</pct_75_to_100K>
	<pct_100_to_125K>1.27</pct_100_to_125K>
	<pct_125_to_150K>10.01</pct_125_to_150K>
	<pct_over_150K>10.44</pct_over_150K>
	<details count="6" interval="perday" list_size="6" has_more_items="false">
		<entry>
			<date>2010-11-15</date>
			<pct_0_to_20K>13.88</pct_0_to_20K>
			<pct_20_to_30K>10.75</pct_20_to_30K>
			<pct_30_to_40K>9.0</pct_30_to_40K>
			<pct_40_to_50K>7.3</pct_40_to_50K>
			<pct_50_to_60K>8.87</pct_50_to_60K>
			<pct_60_to_75K>13.82</pct_60_to_75K>
			<pct_75_to_100K>15.77</pct_75_to_100K>
			<pct_100_to_125K>1.26</pct_100_to_125K>
			<pct_125_to_150K>9.37</pct_125_to_150K>
			<pct_over_150K>9.98</pct_over_150K>
		</entry>
                .
                .
                .
		<entry>
			<date>2010-11-20</date>
			<pct_0_to_20K>13.96</pct_0_to_20K>
			<pct_20_to_30K>10.78</pct_20_to_30K>
			<pct_30_to_40K>9.26</pct_30_to_40K>
			<pct_40_to_50K>7.27</pct_40_to_50K>
			<pct_50_to_60K>8.28</pct_50_to_60K>
			<pct_60_to_75K>12.51</pct_60_to_75K>
			<pct_75_to_100K>15.74</pct_75_to_100K>
			<pct_100_to_125K>1.2</pct_100_to_125K>
			<pct_125_to_150K>10.35</pct_125_to_150K>
			<pct_over_150K>10.66</pct_over_150K>
		</entry>
	</details>
</response>

Error Codes

Standard error codes