API v3 Reference
- Intro
- Authenticating
- get_video_status

- launch_video

- launch_cross_post

- launch_destination

- launch_feed

- list_available_sites

- list_available_destinations

- list_available_feeds

- list_available_cross_post_sites

- list_categories

- list_campaigns

- list_uploads

- list_upload_video_stats

- upload_video

- upload_video_url

- which_host

- recall_video

- add_mrss_feed

- get_mrss_feed_status

- Additional Inplay Info
- get_views

- get_viewed_minutes

- get_unique_viewers

- get_new_viewers

- get_video_list_analytics

- get_video_engagement

- get_player_embeds

- get_geo_analytics

- get_categories

- get_traffic_sources

- get_search_terms

- get_attention_span

- get_bandwidth_usage

- get_stream_rebuffers

- get_start_delays

- get_video_list_performance

- get_geo_performance

- get_os

- get_browser

- get_runtime

- get_demographics_age

- get_demographics_gender

- get_demographics_hh_income

- get_demographics_marital_status

- get_demographics_children

- get_demographics_homeowners

- get_trackers

- create_tracker

- update_tracker

- get_publishers

- share_inplay

- share_revoke

- share_list

- List of Video Sites
- PHP Reference Application
- Info For Partners
- Timezones
- Troubleshooting
Getting Started
Upload
InPlay
InPlay Admin
Appendix
get_demographics_homeowners
Gets the ratio of viewers who own a home versus rent for a specific tracker or publisher ID.
Explorer
Request URL
http://api.tubemogul.com/api/v3/
HTTP method
GET
Arguments
scope(string)- The scope of the method being called. Valid values are
trackerorpublisher. 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
perdayornone. A value ofnonewill omit the detail list. Defaults tonone.
Response Parameters
pct_homeowners (integer)- The percentage of viewers who own their own homes.
pct_rent (integer)- The percentage of viewers who rent their homes.
details (list)- A list of percentage buckets over time with the following parameters:
date, pct_homeowners and pct_rent. 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_homeowners&interval=perday &start=2010-11-15&end=2010-11-20&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e460.57 39.43 . . . 2010-11-15 59.81 40.19 2010-11-20 60.12 39.88
Error Codes
Standard error codes