Version 3 / Linear TV

Authorisation

Please note : All request need to include Authorisation keys in the HTTP header.You can find details here

Linear TV data segmented by Broadcaster
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByBroadcaster?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
Linear TV data segmented by Country
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByCountry?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
Linear TV data segmented by Country and then by Broadcaster and then by Date
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByCountryByBroadcasterByDate?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
Linear TV data segmented by Country and then by Broadcaster and then by Date and then by Programme Type and then by Broadcast Type
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByCountryByBroadcasterByDateByProgramTypeByBroadcastType?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
POST
https://sportsboard-api.yougov.com/v3/LinearTV/GetByCountryByBroadcasterByDateByProgramTypeByBroadcastType?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 183 days
Request Body
  • { "eventIds" : [123,456] } - EventIds Count must be between 1 to 25
Linear TV data segmented by Country and then by Broadcaster and then by Date and then by Sport
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByCountryByBroadcasterByDateBySport?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
Linear TV data segmented by Country and then by Broadcaster and then by Date and then by Sport and then by Sponsor
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByCountryByBroadcasterByDateBySportBySponsor?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
POST
https://sportsboard-api.yougov.com/v3/LinearTV/GetByCountryByBroadcasterByDateBySportBySponsor?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 183 days
Request Body
  • { "eventIds" : [123,456] } - EventIds Count must be between 1 to 25
Linear TV data segmented by Date
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByDate?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
Linear TV data segmented by Event
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetByEvent?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
POST
https://sportsboard-api.yougov.com/v3/LinearTV/GetByEvent?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 183 days
Request Body
  • { "eventIds" : [123,456] } - EventIds Count must be between 1 to 25
Linear TV data segmented by Source
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetBySource?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
Linear TV data segmented by Sponsor
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetBySponsor?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
POST
https://sportsboard-api.yougov.com/v3/LinearTV/GetBySponsor?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 183 days
Request Body
  • { "eventIds" : [123,456] } - EventIds Count must be between 1 to 25
Linear TV data segmented by Sponsor and then by Source
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetBySponsorBySource?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days
Linear TV data segmented by Sponsor and then by Source by date
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetBySponsorBySourceByDate?datefrom={datefrom}&dateto={dateto}
Query Strings
  • datefrom : Start Date (yyyy-mm-dd)
  • dateto : End Date (yyyy-mm-dd) - Date range must not exceed 11 days

Returns available data date ranges per endpoint by media type (e.g. TvRating or Linear TV)
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetDataAvailability?lastInsertedDateTime={lastInsertedDateTime}
Get EventIds available for api requests
GET
https://sportsboard-api.yougov.com/v3/LinearTV/GetEventMeta