Search Broadcasts
Search for Live TV broadcasts happening in a location.
Results are limited by your subscription
Please note that you will not receive an error when requesting a date range or location that is outside of your subscription settings.
This is sometimes confused with missing data. If you're not seeing the results you expect to see then please ensure your subscription covers the location or time period you're searching for.
Your subscription settings can be viewed in Control Center.
Request
HTTP Request
Query Parameters
Parameter | Description |
---|---|
| Find broadcasts by unique identifier. Multiple values are accepted as a comma-separated list.
E.g. |
| Find broadcasts by broadcast status. Multiple values are accepted as a comma-separated list. Possible values:
E.g. |
| Find broadcasts by their physical event’s category. Possible values:
E.g. |
| Find broadcasts by their physical event’s unique identifier. Multiple values are accepted as a comma-separated list. Events in the Broadcasts API have the same identifiers as those in the Events API E.g. |
| Find broadcasts by their entity's unique identifier. Multiple values are accepted as a comma-separated list. Entities in the Broadcasts API have the same identifiers as those in the Events API. This parameter can be used to filter broadcasts by team, e.g. E.g. |
| Find broadcasts by their physical event’s labels. Multiple values are accepted as a comma-separated list. Where multiple labels are provided, broadcasts which match any of the labels are returned. Please note that all event labels are lowercase and that the search is case sensitive. E.g. |
| Find broadcasts by the time they were seen for the first time. Supported suffixes are:
The format of E.g. |
| The maximum number of results to return per page.
The default limit is
E.g. |
| Find broadcasts by their location's Places in the Broadcasts API have the same identifiers as those in the Places API. All broadcast location places are counties, but this parameter accepts other types of places in the hierarchy. See Places for different place types.
A CSV file of broadcast counties is available. It contains the E.g. |
| Find broadcasts in the county for the provided geopoint (a latitude and longitude coordinate). The format of the geopoint is
The Broadcasts API returns broadcasts at the county level. When you specify a geopoint using If you specify a geopoint within Los Angeles County then broadcasts for Los Angeles County will be returned.
E.g. |
| The number of results to skip.
The default is
E.g. |
| Find broadcasts by their PHQ Viewership number. Supported suffixes are:
E.g. |
| Find broadcasts by their record status. Multiple values are accepted as a comma-separated list. Possible values:
The default is
E.g. |
| Fields to order the results by. Multiple values are accepted as a comma-separated list.
The default is Possible values:*
E.g. |
| Find broadcasts by their start time. Supported suffixes are:
The format of start times for this parameter is E.g. |
| Find broadcasts by the time they were last updated. Supported suffixes are:
E.g. |
Mapping File
Below is a CSV of broadcast counties. It contains the place_id
and name of all counties and states in the US.
Response
Response Fields
Below are the fields returned by the Broadcasts endpoint.
Field | Description |
---|---|
| The unique identifier.
E.g. |
| The schedule status of the broadcast. Possible values:
Our guide on different sport types in the API explains when the
E.g. |
| The |
| The time the broadcast is scheduled to start, in UTC. In
E.g. |
| The time the broadcast is scheduled to start in the time zone of the broadcast’s location. In
E.g. |
| The time zone of the broadcast’s location. In TZ Database name format.
E.g. |
| The active record unique identifier the current broadcast is a duplicate of. Please note that this field is only present for records with record status
E.g. |
| The |
| The Aviation Rank number of the physical event. Aviation Rank represents the physical event’s impact on flight bookings by considering both domestic and international travel.
E.g. |
| The category of the physical event.
E.g. |
| Details about the time of the physical event. Fields:
E.g. |
| Venue entities linked to the physical event. E.g. |
| The unique identifier of the physical event. Events in the Broadcasts API have the same identifiers as those in the Events API.
E.g. |
| The labels associated with the physical event.
E.g. |
| The Local Rank number of the physical event. Local Rank represents the physical event’s impact on its local geographical location.
E.g. |
| Details about the location of the physical event. Fields:
E.g. |
| The number of people predicted to attend the physical event.
E.g. |
| The PHQ Rank number of the physical event. PHQ Rank represents the physical event’s impact independent of its geographical location.
E.g. |
| The title of the physical event.
E.g. |
| The time the broadcast was seen for the first time. In
E.g. |
| The |
| The country code of the location where the broadcast is televised. In ISO 3166-1 alpha-2 format.
E.g. |
| The latitude and longitude coordinates of the location where the broadcast is televised. E.g. |
| An array of place hierarchies for the location where the broadcast is televised. A broadcast record is only televised in one location. A hierarchy is an array of place ids (see Places). The final id in a hierarchy is the place_id of the place where the broadcast is televised. E.g. |
| An array of place details for the place where the broadcast is televised. A broadcast record is only televised in one place. A place object has these fields:
A CSV file of broadcast counties is available. It contains the E.g. |
| The estimated number of people in the broadcast’s location that will watch the broadcast.
E.g. |
| The record status of the broadcast. Possible values:
E.g. |
| The time the broadcast was last updated. In
E.g. |
Examples
Guides
Below are some guides relevant to this API:
Last updated