ESPN News Content
News and Headlines
Sports should always be front page news
The ESPN Headlines API allows you to interact with ESPN's various news stories. ESPN publishes hundreds of unique pieces of text content each day, covering dozens of sports and hundreds of athletes and teams.
This API is currently a version 1 (/v1/) release.
Availability Public Partner Premium Partner ESPN
This API is great for:
- Printing the latest sports headlines
- Using ESPN content in reader applications
- Creating a Top Stories app
- Finding content related to an ESPN story
- Replacing an ESPN RSS feed for use in an app
- Delivering ESPN stories to any screen
The ESPN Headlines API accepts a GET request.
Users have the option of requesting an editorially-selected collection of ESPN Headlines content, or a "fire hose" of content relevant to a particular sport or section on ESPN.
The format of an API request is as follows:
Sample Headlines Requests
Action URI Description GET http://api.espn.com/v1/sports/news/headlines/top Top editorially-curated news as shown on ESPN.com home page. GET http://api.espn.com/v1/sports/news/headlines Top editorially-curated news aggregated across all sports. GET http://api.espn.com/v1/sports/basketball/nba/news/headlines Top editorially-curated NBA news. GET http://api.espn.com/v1/sports/basketball/nba/news "Fire hose" of NBA-related news. GET http://api.espn.com/v1/sports/basketball/nba/news?dates=20100219 NBA news published on a specific date. GET http://api.espn.com/v1/sports/soccer/fifa.olympics/news Olympics soccer news from current day. GET http://api.espn.com/v1/sports/soccer/eng.1/news/headlines Top editorially-curated soccer news for the Barclays Premier League. GET http://api.espn.com/v1/sports/baseball/mlb/news/headlines?lang=es Top editorially-curated MLB news in Spanish, as determined by ESPNDeportes.com. GET http://api.espn.com/v1/fantasy/football/news Current day's Fantasy Football news from ESPN's experts. GET http://api.espn.com/v1/sports/news/headlines/top?lang=es®ion=ar Top editorially-curated sports news in Spanish-speaking Argentina, as determined by ESPNDeportes.com. GET http://api.espn.com/v1/sports/news/6277112 Full text for a specific story. Subject to access tier.
Resource Name Description Availability public partner premium
espn /cities News from ESPN's regional City sites. Currently includes Boston, Chicago, Dallas, Los Angeles, and New York. /cities/boston News from ESPNBoston.com /cities/chicago News from ESPNChicago.com /cities/dallas News from ESPNDallas.com /cities/los-angeles News from ESPNLA.com /cities/new-york News from ESPNNewYork.com /espnw News as published on espnW.com, ESPN's primary destination for women's sports /fantasy News and analysis from ESPN's Fantasy experts, covering Fantasy Football, Fantasy Baseball, Fantasy Basketball, Fantasy Hockey, and more. /fantasy/baseball Fantasy Baseball /fantasy/basketball Fantasy Basketball /fantasy/football Fantasy Football /fantasy/hockey Fantasy Hockey /magazine ESPN Magazine /sports/action-sports X Games /sports/action-sports/bmx X Games BMX /sports/action-sports/moto-x X Games Moto X /sports/action-sports/skateboarding X Games Skateboarding /sports/action-sports/skiing X Games Skiing /sports/action-sports/snowboarding X Games Snowboarding /sports/action-sports/snowmobiling X Games Snowmobiling /sports/action-sports/surfing X Games Surfing /sports/action-sports/rally X Games Rally /sports/baseball/mlb Major League Baseball (MLB) /sports/basketball/mens-college-basketball NCAA Men's College Basketball /sports/basketball/nba National Basketball Association (NBA) /sports/basketball/wnba Women's National Basketball Association (WNBA) /sports/basketball/womens-college-basketball NCAA Women's College Basketball /sports/boxing Boxing /sports/football/college-football NCAA College Football /sports/football/nfl National Football League (NFL) /sports/golf Golf /sports/hockey/nhl National Hockey League (NHL) /sports/horse-racing Horse Racing /sports/mma Mixed Martial Arts /sports/olympics Olympic sports /sports/racing Auto Racing /sports/racing/nascar NASCAR racing /sports/soccer Professional soccer (US focus) /sports/soccer/:leagueName Specific professional soccer league. Use a helper API call for a complete list of supported soccer leagues. /sports/tennis Tennis
MethodsBack to top
In addition to the standard URI parameters, the ESPN Headlines API also supports the following URI parameters:
Requests to the ESPN Headlines API return the following data:Back to top
The following XML output was rendered with a public developer key calling:
The following JSON output was rendered with a public key calling: