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
    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/baseball/mlb/recordings Get recordings related to the MLB.
    GET http://api.espn.com/v1/audio/categories Return a list of ESPN podcast categories.
    GET http://api.espn.com/v1/audio/categories/13479703/podcasts Return a list of FiveThirtyEight.
    GET http://api.espn.com/v1/audio/categories/featured/podcasts Return a list of podcasts in the "featured" category.
    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/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/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/2156024 Get information about a specified show. For example, "Mike & Mike in the Morning".
    GET http://api.espn.com/v1/audio/shows/2156024/airings Get airings for a specified show.
  • Quick Navigation

    Resources

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

     

    Methods

    Method Description Availability
    strategic
    partner
    espn
    /categories Array of all ESPN podcast categories.
    /categories/:categoryId/podcasts Array of all ESPN podcasts within a category.
    /categories/featured/podcasts Array of all ESPN podcasts within the "featured" category.
    /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
    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. Return ESPN Deportes content. Valid for the following methods only: /podcasts, /podcasts/:id, and /podcasts/:id/recordings, and /stations.
    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
    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.
    backgrounds Array of background image objects. Not provided for some airings. See the Backgrounds Object for details.
    Back to top

    Podcasts Object

    Element Description Availability
    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.
    backgrounds Array of background images. See the Backgrounds Object for details.
    Back to top

    Recordings Object

    Element Description Availability
    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.
    duration Integer duration of the recording in seconds.
    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.
    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.
    featureUntilDate String timestamp in the form of YYYY-MM-DDThh:mm:ssZ. This date can be used to determine when to display audio clips in featured areas in an application, such as Most Recent, Top Clips, or Trending Clips section that requires all clips in the collection be newsworthy and current.
    priority Priority is a rating set by ESPN Digital Audio Editorial indicating the relative importance of a clip on a 1-10 scale, 1 being the most important. It is recommended that applications order clips by default utilizing the Priority field combined with the "Published" field, which indicates the date and time a clip was published. For example, clips could have a default order in an application in ascending order by [Priority] + [Days Old (derived from current date - published date], and abiding by any FeatureUntilDate that is set.
    subtitle String name that may use the same value as shortDescription. When set to a value, this drives alerting in ESPN applications.
    Back to top

    Shows Object

    Element Description Availability
    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.
    backgrounds Array of background image objects. See the Backgrounds Object for details.
    Back to top

    Stations Object

    Element Description Availability
    strategic
    partner
    espn
    id Integer ID of the station.
    lang String indicating the language of the station. For example, "en" for english.
    type String indicating the station type. Either "Local", "National", or "O&O" (Owned & Operated).
    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.
    callLetters String name of the station call letters. For example, "W-ESPN".
    mobileCallLetters String name of the stations mobile call letters. For example, "WEPNAM".
    stationKey Sting name of the station key. For example, "espn".
    Back to top

    Backgrounds Object

    Element Description Availability
    strategic
    partner
    espn
    height Integer height of the image in pixels.
    alt String alt text for the image.
    width Integer width of the image in pixels.
    name String title or description of the image.
    credit String photo credit for the image.
    url String URI of the image file.
    Back to top

     

    Categories Object

    Element Description Availability
    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
    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