The ESPN Now API accepts a GET request.

Developers can return a stream of the latest content published on ESPN.com, or limit to editorially curated content or popular content.

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

Sample Now Requests

Quick Navigation

• Resources
• Methods
• URI Parameters

Resources

Resource Name	Description	Availability
		public	partner	premium partner	espn
/now	Stream of the latest content published on ESPN.com.

Methods

Method	Description	Availability
		public	partner	premium partner	espn
/	Latest ESPN.com content.
/top	Top content as selected by ESPN's editorial staff.
/popular	Most popular ESPN content.

URI Parameters

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

Parameter	Value & Description	Availability
		public	partner	premium partner	espn
leagues	String denoting a particular sport category or sports league/organizing body. Not applicable to /top and /popular methods. Note: Currently this param only accepts a single value. Possible values are listed below:
	boxing Boxing
	college-football NCAA Football
	golf Golf
	mens-college-basketball NCAA Men's Basketball
	mlb Major League Baseball
	mma Mixed Martial Arts
	nascar NASCAR Racing
	nba National Basketball Association
	nfl National Football League
	nhl National Hockey League
	olympics Olympic Sports
	racing Auto Racing
	soccer Soccer
	tennis Tennis
	wnba Women's National Basketball Association (WNBA)
	womens-college-basketball NCAA Women's Basketball
teams	Comma-separated list of team IDs to filter by. Requires 'leagues' being set. Not applicable to /top and /popular methods. Note: Currently this param only accepts a single value.
content	Comma-separated list of content types to filter by. Only applicable to the base /now endpoint with no teams or leagues parameters. Supported content type filters are below:
	video
disable	Optional flag to disable specific information, with the following options. Accepts a single value or a comma delimited string of values (i.e. disable=a,b,c).
	breakingnews Disables the breakingNews property.
	metrics Disables the 'metrics' array.
	categories Disables the 'categories' array, if it exists for the story.

Back to top

Quick Navigation

• Returned Data
• Sample Response

Returned Data

Requests to the ESPN Now API return the following data:

Element	Description	Availability
		public	partner	premium partner	espn
breakingNews	Property containing editorial copy about a breaking news story. This field is not always present or filled in if there is no breaking news story to report.
feed	Array of feed objects, each containing the following properties:
	title Title tag/meta title of the content.
	headline Headline for the content.
	lastModified Last time the story was updated, expressed in standard DateTime data type ("yyyy-MM-ddTHH:mm:ssZ").
	published The date the story was first published, expressed in standard DateTime data type ("yyyy-MM-ddTHH:mm:ssZ").
	description A 1-2 sentence summary/tease of the content.
	source The news source, e.g. ESPN.com News, AP, etc. Not applicable to all content.
	metrics Array of 'metrics' objects, each containing the following properties:
	type - The type of metric. Possible values include views, fShares, tweets, comments, emails, votes, and popularity. Note that all metrics won't exist for every content type.
	count - Integer value associated with the metric.
	byline The author. Not applicable to all content.
	categories Structured collection of keyword meta data, each with the following data:
	description - The full name associated with the category.
	links - Links to the specific API call and Web and Mobile URLs for the data.
	type - The type of category, e.g. sport, team, league, or athlete.
	sportId - The API id for the sport.
	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).
	linkText Short text suitable for use in HTML anchor tags.
	premium Refers to whether a piece of content is ESPN Insider (premium). Possible values are "true" or "false".
	type The content type, according to ESPN's publishing classifications.
	section The site section the content was published in. Not always returned depending on content type.
	blogName Key value corresponding to the blog the content was published in, if the content type is a blog entry.
	id Unique content ID for the content in ESPN's publishing system.
	images A collection of images related to the content, each with the following data:
	name - The title for the image.
	url - The URL for the image.
	alt - ALT text if available.
	caption - A caption for the image if available.
	credit - Any copyright information associated with the image.
	width - The image width.
	height - The image height.
	links Objects containing links to both API hypermedia and Web/Mobile URLs if available.
	web - Object containing Web-optimized URL to the content.
	mobile - Object containing Mobile-optimized URL to the content.
	api - Object containing links to related API calls for the content.

Sample Response