WatchESPN Network Programming Listings

WatchESPN

The ESPN Networks. Live. Anywhere.
  • Accessing live sports and shows from ESPN is now easier than ever for developers with the WatchESPN API. WatchESPN delivers 24/7 live programming from ESPN Networks to computers, mobile phones, game consoles, and tablets.

    This API is currently a version 1 (/v1/) release.

    Availability
    Strategic Partner ESPN
  • The WatchESPN API accepts a GET request.

    Developers can return information about programming across ESPN's family of networks, including in-progress video streams, upcoming events, and programming replays.

    The format of an API request is as follows:
    http://api.espn.com/:version/:resource/:method?apikey=:yourkey

    Sample WatchESPN Requests

    Action URI Description
    GET http://api.espn.com/v1/watch/listings Live, upcoming, and replay programming across all WatchESPN networks.
    GET http://api.espn.com/v1/watch/listings/top Top ESPN programming, as determined by ESPN's editorial staff.
    GET http://api.espn.com/v1/watch/listings?networks=espn2 Programming information for ESPN2 network.
    GET http://api.espn.com/v1/watch/listings?networks=espn3&types=replay Programming on ESPN3 network available for replay.
    GET http://api.espn.com/v1/watch/listings?types=upcoming&dates=20131201 Upcoming programming on December 1, 2013 for all networks.
    GET http://api.espn.com/v1/watch/categories ESPN programming categories.
    GET http://api.espn.com/v1/watch/categories/sr/listings?networks=espn,espn2,espnu,espnews&
    type=upcoming,live&dates=20130909-20130910
    Programming from Sept 9-10th, 2013 in the SportsCenter category, across specific networks, that has not aired yet.
  • Quick Navigation

    Resources

    Resource Name Description Availability
    strategic
    partner
    espn
    /watch WatchESPN
    Back to top

     

    Methods

    Method Description Availability
    strategic
    partner
    espn
    /listings WatchESPN programming (show) information.
    /listings/popular Top live WatchESPN programming as determined by number of active viewers. Top replay listings (as determined by peak concurrent viewers) may be returned by passing "networks=espn3" as a parameter.
    /listings/top Top programming (show) information across ESPN's networks, as determined by ESPNs's editorial staff.
    /listings/:id Data associated with a specific program listing.
    /networks WatchESPN programming networks.
    /categories WatchESPN programming categories and subcategories.
    /categories/:categoryAbbreviation/listings Programming information for a specific category.
    /categories/:categoryAbbreviation/listings/top Top programming (show) information for a specific category, as determined by ESPN's editorial staff.
    /categories/top Top WatchESPN programming categories and subcategories, as determined by ESPN's editorial staff.
    /subcategories/:subCategoryAbbreviation/listings Programming information for a specific subcategory.
    /subcategories/:subCategoryAbbreviation/listings/top Top programming (show) information for a specific subcategory, as determined by ESPNs's editorial staff.
    Back to top

     

    URI Parameters

    In addition to the standard URI parameters, the ESPN Now API also supports the following URI parameters:

    Parameter Value & Description Availability
    strategic
    partner
    espn
    dates Integer in the form of "yyyymmdd" to get programming information for a particular date. If not passed will default to the current date. Two Integers separated by a dash may be used to specify a date range (e.g. '20121201-20121231'). Only applicable to /listings methods.
    types Comma-separated list of String values to denote current, past, or upcoming programming. Only applicable to /listings methods. Possible values are:
    live Only live programming.
    upcoming Programming that has not yet started. Defaults to 12 hours of upcoming programming.
    replay Archived programming available for replay. Defaults to the past 7 days of replay programming.
    networks Comma-separated list of network names used to limit output to a set of networks. Networks currently available:
    espn ESPN
    espn2 ESPN2
    espn3 ESPN3
    espndeportes ESPN Deportes
    espnu ESPNU
    goalline GoalLine
    buzzerbeater BuzzerBeater
    enable Optional flag to enable specific information, with the following options. Accepts a single value or a comma delimited string of values (i.e. enable=a,b,c).
    networksort Enables sorting of results in ESPN's preferred order.
    analytics Enables analytics information.
    keywords Comma separated list of keywords to filter the results by.
    categories Comma separated list of Integers (e.g. categories=1,2) that limits the listing results to a set of programming categories.
    subcategories Comma separated list of Integers (e.g. subcategories=1,2) that limits the listing results to a set of programming subcategories.
    days Integer value that limits the results returned to the past x days. Only applicable to the /popular method.
    lang Can be used to return content in the specified language. Supported languages are below. Note: not all content is available in multiple languages.
    en English. Default language.
    es Spanish.

    Back to top

     

  • Quick Navigation

    Returned Data

    Requests to the WatchESPN API return the following data:

    Element Description Availability
    strategic
    partner
    espn
    categories An array of category objects. Root level array only applies to the /categories method. Each category objects contains the following properties:
    name The full name associated with the category.
    abbreviation The abbreviation for the category.
    id Integer ID of the category in ESPN's NCS database.
    sportId The unique ID of the category in the WatchESPN content management system.
    subCategories An array of programming subcategories associated with the category. Each includes the following properties:
    name - The full name associated with the subcategory.
    shortName - Shorter version of the subcategory's name.
    abbreviation - The subcategory's abbreviation.
    id - Integer ID of the subcategory in ESPN's NCS database.
    leagueId - The ID of the league in ESPN's APIs associated with the category.
    networks An array of network objcts. Only applies to the /networks method. Each network object contains the following properties:
    id The unique ID of the network in ESPN's NCS database.
    name The full name of the network.
    abbreviation The abbreviation for the network.
    type The network's type (e.g. linear, online, etc.)
    isActive Boolean that indicates if the network is active.
    images An object containing references to various sizes of logo images. Contains the following properties:
    small - Small image object containing width/height/href properties.
    listings An array of listings objects with the following properties:
    name The name of the program.
    shortName Shorter version of the program name, if available.
    description A description of the programming event.
    id The unique ID of the program in the WatchESPN content management system.
    episodeId The unique episode ID of the program.
    airingId The unique airing ID for a particular episode.
    simulcastAiringId The unique simulcast ID for a particular airing of the episode. This ID will be the same across networks when an event is on ESPN3 and a linear network (ESPN, ESPN2, ESPNU).
    eventId Integer ID corresponding to the match/game being played. Useful for relationship between a particular program and scores/stats/video/news data about the same match/game.
    eventStatus A string describing the status of the event.
    type Enumerator value indicating the state of the program. Possible values are:
    live
    upcoming
    replay
    startTime The scheduled start time of the program in the format of "yyyy-MM-ddTHH:mm:ssEST".
    broadcastStartTime The actual time the program's broadcast started in the format of "yyyy-MM-ddTHH:mm:ssEST".
    endTime The actual end time of the broadcast in the format of "yyyy-MM-ddTHH:mm:ssEST".
    seekInSeconds Integer indicating the number of seconds into the HLS video stream that the event actually started.
    lang The language of the broadcast. Languages currently supported:
    en - English
    es - Spanish
    broadcasts An array of platforms the program is available on, each with the following properties:
    type - The type of broadcast. Possible values include "TV", "Radio", etc.
    typeId - Integer ID corresponding to the type.
    ncsId - String ID corresponding to the ESPN NCS networkID for the network.
    name - Name of the broadcast platform, e.g. "ESPN News" or "ESPN2".
    shortName - Short name of the broadcast platform if applicable.
    callLetters - The identifying code letters or numbers of the radio or television transmitting station.
    program Object with information from ESPN's NCS database, containing the following properties:
    code - Two character String code denoting the sub group of the program.
    sportLevel - String which identifies the sport level of the program (e.g. Professional, College, etc.)
    isStudio - Boolean identifying a studio show.
    categoryCode - Two character String code denoting the major group of the program.
    id - String ID of the program in ESPN's NCS database.
    categories An array of meta categories associated with the program, each including the following properties:
    name - The full name of the category.
    id - Integer ID of the category in ESPN's NCS database.
    sportId - The ID of the sport in ESPN's APIs associated with the category.
    abbreviation - The abbreviation for the category.
    subCategories An array of meta categories associated with the program, each including the following properties:
    name - The full name associated with the subcategory.
    shortName - Shorter version of the subcategory's name.
    abbreviation - The subcategory's abbreviation.
    id - Integer ID of the subcategory in ESPN's NCS database.
    leagueId - The ID of the league in ESPN's APIs associated with the category.
    competitors Array of teams or individuals competing in the event. Does not apply to studio shows. See Scores API for more information on competitor objects.
    thumbnails Object containing references to various sizes of image thumbnails related to the program. Contains the following properties
    small - Small thumbnail object containing width/height/href properties.
    medium - Medium thumbnail object containing width/height/href properties.
    large - Large thumbnail object containing width/height/href properties.
    scoreboard - Thumbnail object optimized for ESPN scoreboard products containing width/height/href properties.
    blackouts Array of blackout objects containing the following properties:
    type - Enumerator value indicating the type of blackout restriction. Possible values are timezone/dma/device/state.
    details - Array of string values corresponding to the type of blackout.
    parentalRating String value denoting the parental rating of the program.
    hasReplay Indicates the live event will be available for replay after it is over. Currently only valid for online events.
    aspectRatio The aspect ratio of the event's video streams.
    closedCaptions Object containing information about the event's closed captioning.
    enabled - Boolean indicating if closed captions are enabled for the event.
    position - String indicating the desired position of the closed captions. Possible values include "bottomLeft" or "bottomRight".
    guid Unique string for the program.
    links Object containing links to both API hypermedia, video assets, and Web/Mobile URLs if applicable. Currently includes the following categories of links:
    web - Object containing a link to the event on WatchESPN.com
    source - Object containing links to source video streams.
    api - Object containing links to related API calls for WatchESPN program.
    analytics An object containing an assortment of key/value pairs used for analytics tracking.
    Back to top

     

    Sample Response

    XML

     

    JSON
    Back to top