ESPN Audio Content

Audio

It’s time to tell it like it is, sports fans
  • 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.
    shows Enables including a shows object with information about the show related to an airing. 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

    Depending on the endpoint and paramters specified for a request to the ESPN Audio API, the returned data may include one or more of the Airings, Podcasts, Recordings, Shows and Stations objects.

    Typically, the endpoint called correlates with object returned. For example, the response from calling the /podcasts endpoint includes a podcasts array containing individual podcast objects.

    Responses from the /airings endpoint may contain both the airings array and an associated podcasts, recordings, shows or stations object.

    Airings Object

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of the airing.
    headline String title of the airing, typically the title of the associated podcast or show. For example, "The Herd".
    startDate Timestamp indicating when the podcast or show is scheduled to begin.
    endDate imestamp indicating when the podcast or show is scheduled to end.
    links Object containing platform-optimized links to the content, if available. See the Links Object for details.
    categories Array of objects containing keyword metadata related to the story. See the Categories Object for details.
    show Object containing metadata for the show related to the airing, when applicable. See the Shows Object for details.
    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.
    Back to top

    Podcasts Object

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of the podcast.
    lang String indicating the language of the podcast. For example, "en" for english.
    updated Timestamp indicating when the podcast was last updated. This often refers to when a new recording was added to this podcast.
    premium Boolean indicating whether the podcast is premium ESPN Insider content.
    headline String title of the podcast.
    description String description of the podcast series.
    links Object containing platform-optimized links to the content, if available. See the Links Object for details.
    thumbnails Object containing thumbnail images for the podcast. Available sizes include 90×90 (xsmall), 134×75 (small), 288×162 (large), 203×114 (medium) and 300×300 (xlarge).
    Back to top

    Recordings Object

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of the recording.
    lang String indicating the language of the recording. For example, "en" for english.
    published Timestamp indicating when the recording was published.
    premium Boolean indicating whether the recording is premium ESPN Insider content.
    headline String title of the individual recording.
    shortDescription String sub-heading or short description of the recording.
    description String description of the recording content.
    links Object containing platform-optimized links to the content, if available. See the Links Object for details.
    thumbnails Object containing thumbnail images for the podcast. Available sizes include 90×90 (xsmall), 134×75 (small), 288×162 (large), 203×114 (medium) and 300×300 (xlarge).
    categories Array of objects containing keyword metadata related to the story. See the Categories Object for details.
    keywords Array of keyword strings for topics related to the story.
    Back to top

    Shows Object

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of the show.
    lang String indicating the language of the show. For example, "en" for english.
    updated Timestamp indicating when the show last aired.
    premium Boolean indicating whether the show is premium ESPN Insider content.
    headline String title of the show. For example, "The Herd".
    description String description of the show.
    links Object containing platform-optimized links to the content, if available. See the Links Object for details.
    thumbnails Object containing thumbnail images for the show. Available sizes include 300×300 (xlarge), 640×640 (tablet), 1280×1280 (desktop) and 1920×1920 (xldesktop).
    Back to top

    Stations Object

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of the station.
    lang String indicating the language of the station. For example, "en" for english.
    premium Boolean indicating whether the station provides premium ESPN Insider content.
    headline String name of the station. For example, "ESPN Radio".
    links Object containing platform-optimized links to the content, if available. See the Links Object for details.
    thumbnails Object containing thumbnail images for the station. Available sizes include 300×300 (xlarge), 640×640 (tablet), 1280×1280 (desktop) and 1920×1920 (xldesktop).
    airing Object containing metadata for the most recent show airing available for the station. See the Airings Object for details.
    Back to top

    Categories Object

    Element Description Availability
    public strategic
    partner
    espn
    description String title of the associated content or category. For example, "The Herd" for a show or "MLB" for a league.
    type String description of the category type. Supported types include "athlete", "league", "podcast", "show" or "team".
    sportId Integer ID of the related sport, when the type is "athlete", "league" or "team".
    leagueId Integer ID of the related league, when the type is "league".
    league Object containing the id and description properties along with links for league content, when the type is "league".
    teamId Integer ID of the related team, when the type is "team".
    team Object containing id and description properties along with links for team content, when the type is "team".
    athleteId Integer ID of the related athlete, when the type is "athlete".
    athlete Object containing id and description properties along with links for athlete content, when the type is "athlete".
    podcastId Integer ID of the related podcast, when the type is "podcast".
    podcast Object containing id and description properties along with links for additional content, when the type is "podcast".
    showID Integer ID of the related show, when the type is "show".
    show Object containing id and description properties along with links for additional content, when the type is "show".
    uid A globally unique string identifier for the sports entity when the type is "league" or "team".
    Back to top
    Element Description Availability
    public strategic
    partner
    espn
    api Object containing links to related API calls for the content.
    web Object containing URLs for web-optimized content.
    mobile Object containing URLs for mobile-optimized content.
    app Object containing URLs for an app-related feed for the content.
    source Object containing URLs for various non-optimized, source content formats. Typically associated with video content.
    Back to top

     

    Sample Response

    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