ESPN Audio Content

Audio beta

  • The ESPN Audio API allows you to interact with ESPN's on-demand audio content. This includes ESPN's 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 and audio recording by podcast (essentially a type of audio channel) 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.
  • 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.
    /shows/:showId/recordings Recordings for a specific live radio show.

     

    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.
    insider
    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
    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 (multiple sizes available).
    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 podcast (multiple sizes available).
    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 (multiple sizes available).
    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