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

Quick Navigation

• Resources
• Methods
• URI Parameters

Resources

Resource Name	Description	Availability
		public	partner	premium partner	espn
/audio	ESPN audio content

Methods

Method	Description	Availability
		public	partner	premium 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	partner	premium 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.

Quick Navigation

• Returned Data
• Sample Response

Returned Data

Requests to the ESPN Audio API return the following data:

Element	Description	Availability
		public	partner	premium 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 will be removed in a future release. Clients should use the "bitrateDefault" property 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).
	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).

Sample Response