ESPN Audio Content

Audio beta

  • The ESPN Audio API allows you to interact with ESPN on-demand audio content. This includes ESPN podcasts as well as clips from many live shows on ESPN Radio.

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

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

    Users have the option of requesting an audio recording by podcast (essentially a type of audio channel), stations (ESPN Radio), airings (specific programs on show or station) or a "fire hose" of all recent audio recordings. It's important to note that not all recordings belong to a podcast, but all podcasts have recordings.

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

    Sample Audio Requests

    Action URI Description
    GET http://api.espn.com/v1/audio/recordings Get the latest audio recordings published.
    GET http://api.espn.com/v1/audio/recordings/8489644 Return information about a particular recording, e.g. "Tim Kurkjian, MLB" appearing on "Mike & Mike in the Morning."
    GET http://api.espn.com/v1/audio/podcasts Return a list of ESPN Radio podcasts.
    GET http://api.espn.com/v1/audio/podcasts/8375187 Return information about a particular podcast, e.g. "Fantasy Underground."
    GET http://api.espn.com/v1/audio/podcasts/6247496/recordings Get the most recent recordings for a particular podcasts, e.g. "First Take."
    GET http://api.espn.com/v1/audio/baseball/mlb/recordings Get recordings related to the MLB.
    GET http://api.espn.com/v1/audio/stations Get all audio broadcast stations.
    GET http://api.espn.com/v1/audio/stations/4359221 Get a specific station. For example, ESPN Radio.
    GET http://api.espn.com/v1/audio/stations/4359221/airings Get current and upcoming airings (schedule) for a specified station.
    GET http://api.espn.com/v1/audio/shows Get scheduled shows for the specified play date.
    GET http://api.espn.com/v1/audio/shows/2156019 Get information about a specified show. For example, "The Herd with Colin Cowherd".
    GET http://api.espn.com/v1/audio/shows/2156019/airings Get airings for a specified show.
  • Quick Navigation

    Resources

    Resource Name Description Availability
    public strategic
    partner
    espn
    /audio ESPN audio content
    Back to top

     

    Methods

    Method Description Availability
    public strategic
    partner
    espn
    /podcasts Array of all ESPN podcasts.
    /podcasts/:podcastId Information about a particular podcast.
    /podcasts/:podcastId/recordings All recent audio recordings within a particular podcast.
    /recordings Get a firehose of the latest ESPN audio recordings.
    /:sport/recordings Get recordings for a certain sport. Valid sports are boxing, golf, horse-racing, mma, olympics, racing, soccer, and tennis.
    /:sport/:league/recordings Get recordings for a certain sport and league. Valid combinations are baseball/mlb, basketball/nba, basketball/mens-college-basketball, basketball/wnba, basketball/womens-college-basketball, football/nfl, football/college-football, and hockey/nhl.
    /:sport/athletes/:athleteId/recordings Get recordings for a certain athlete within a sport. See above for valid sports.
    /:sport/:league/athletes/:athleteId/recordings Get recordings for a certain athlete in a league. See above for valid sports/league combinations. Use Athlete API to get athlete IDs.
    /:sport/:league/teams/:teamId/recordings Get recordings for a certain team in a league. See above for valid sports/league combinations. Use Team API to get team IDs.
    /recordings/:recordingId Data associated with a specific audio recording.
    /shows Live radio shows.
    /show/:showId Specific live radio show.
    /show/:showId/airings Current and upcoming broadcast schedule for a live radio show.
    /shows/:showId/recordings Recordings for a specific live radio show.
    /stations All supported broadcast radio stations.
    /stations/:stationId A specific broadcast radio station.
    /stations/:stationId/airings Current and upcoming airings (schedule) for a station.
    /airings/:airingId A specific airing.

     

    URI Parameters

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

    Parameter Value & Description Availability
    public strategic
    partner
    espn
    dates Integer in the form of "yyyymmdd" to filter recording results by date. Two Integers separated by a dash may be used to specify a date range (e.g. '20121201-20121231'). Not applicable to the firehose /recordings method.
    enable Optional flag to enable specific information, with the following options. Accepts a single value or a comma delimited string of values (enable=a,b,c).
    airing Enables including the current live airing in the response for the /stations methods. Note that airings are automatically enabled when using the /stations/:stationId/airings and /shows/:showId/airings methods.
    categories Enables including the airing categories. Used only for the /airings method.
    lineup Enables including the airing lineup, the rundown for the show that day. Used only for the /airings method.
    insider Optional flag to specify whether premium (Insider) content is returned.
    yes default value, includes premium and free content
    no only includes free content
    only only includes premium content
    lang Can be used to return content in the specified language. Supported languages are below. Note: not all content is available in multiple languages and will return in English if no alternative is available.
    en English. Default language.
    es Spanish. Valid for following methods only: /podcasts, /podcasts/:id, and /podcasts/:id/recordings.
    Back to top

     

  • Quick Navigation

    Returned Data

    Requests to the ESPN Audio API return the following data:

    Element Description Availability
    public strategic
    partner
    espn
    airings Array of airings objects containing information about the current and upcoming airings (schedule) for a show or station. Contains the following properties:
    id Unique ID of the airing in ESPN's publishing system.
    headline The headline/title for this airing.
    startDate The start time for this airing. An ISO 8601 format date-time value indicating the starting time as UTC.
    endDate The end time for this airing. An ISO 8601 format date-time value indicating the ending time as UTC.
    links Object containing links to airings hypermedia URLs if available.
    api - Object containing links to API hypermedia.
    categories Structured collection of keyword meta data, each with the following properties:
    type - The type of category, e.g. podcast, show, sport, team, league, or athlete.
    showId - The API ID for the radio show (if applicable).
    description - The full name associated with the category.
    show - An object containing information about the radio show including id, description and API URIs.
    lineup An array containing the rundown items for the show. Each item will at minimum include a headline and date. It may also include a thumbnail and a recording. The recording is audio for that segment of the show. See the existing recording model for more details. (disabled by default)
    podcasts Array of podcast objects containing information about the podcast. Contains the following properties:
    id Unique ID of the podcast in ESPN's publishing system.
    lang String indicating the language of the podcast.
    updated The date/time at which this podcast was last updated. This often refers to when a new recording was added to this podcast.
    premium Boolean that indicates whether this podcast is ESPN Insider (premium).
    headline The headline/title for this podcast.
    description The description for this podcast.
    links Object containing links to API hypermedia, Web, and Mobile URLs if available.
    api - Object containing links to API hypermedia.
    web - Object containing Web-optimized URL to the recording.
    mobile - Object containing relevant Mobile link(s).
    thumbnails Thumbnail images for this podcast. Available sizes include 90×90 (xsmall) and 300×300 (xlarge).
    recordings Array of recording objects, each containing the following properties:
    id Unique content ID for the recording in ESPN's publishing system.
    lang String indicating the language of the recording.
    published The date/time at which this recording was published.
    premium Boolean that indicates whether this recording is ESPN Insider (premium).
    headline The recording headline/title.
    shortDescription Short version of the recording description, if available.
    description A description of the recording.
    links Object containing links to API hypermedia, Web, and Mobile URLs if available.
    api - Object containing links to API hypermedia.
    web - Object containing Web-optimized URL to the recording.
    mobile - Object containing relevant Mobile link(s).
    source - Object containing links to various encoded audio assets. NOTE: The "default" property is deprecated and should not be used. Please use "bitrateDefault" instead.
    thumbnails Thumbnail images for this recording. Available sizes include 90×90 (xsmall), 134×75 (small), 288×162 (large), 203×114 (medium) and 300×300 (xlarge).
    categories Structured collection of keyword meta data, each with the following properties:
    description - The full name associated with the category.
    type - The type of category, e.g. podcast, show, sport, team, league, or athlete.
    podcastId - The API id for the radio show (if applicable).
    showId - The API id for the radio show (if applicable).
    sportId - The API id for the sport (if applicable).
    leagueId - The API id for the league (if applicable).
    teamId - The API id for the team (if applicable).
    athleteId - The API id for this athlete (if applicable).
    uid - A globally unique string identifier for the sports entity in ESPN's systems.
    keywords Array of keywords related to the show.
    shows Array of show objects containing information about the podcast. Contains the following properties:
    id Unique ID of the show in ESPN's publishing system.
    lang String indicating the language of the show.
    updated The date/time at which this show was last updated. This often refers to when a new recording was added to this show.
    premium Boolean that indicates whether this show is ESPN Insider (premium).
    headline The headline/title for this show.
    description The description for this show.
    links Object containing links to API hypermedia, Web, and Mobile URLs if available.
    api - Object containing links to API hypermedia.
    web - Object containing Web-optimized URL to the show.
    mobile - Object containing relevant Mobile link(s).
    thumbnails Thumbnail images for this show. Available sizes include 300×300 (xlarge), 640×640 (tablet), 1280×1280 (desktop) and 1920×1920 (xldesktop).
    stations Array of station objects containing information about the radio station. Contains the following properties:
    id Unique ID of the station in ESPN's publishing system.
    lang String indicating the language of the station.
    premium Boolean that indicates whether this show is ESPN Insider (premium).
    headline The name or title for this station.
    links Object containing links to API hypermedia and media source URLs if available.
    api - Object containing links to API hypermedia.
    source - Object containing links to various encoded audio assets. NOTE: The "default" property is deprecated and should not be used. Please use "bitrateDefault" instead.
    thumbnails Thumbnail images for this station. Available sizes include 300×300 (xlarge).
    airing What's currently playing on that station. See the airing model for details. (Disabled by default)
    Back to top

     

    Sample Response

    XML

    The following XML output was rendered with an internal key calling:
    http://api.espn.com/v1/audio/recordings/9939913?_accept=text/xml&apikey=:yourkey.

     

    JSON

    The following JSON output was rendered with an internal key calling:
    http://api.espn.com/v1/audio/recordings/9939913?apikey=:yourkey.

    Back to top