The ESPN Research Notes API accepts a GET request.

Research notes are available for most major sports, including teams and athletes within those sports.

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

Sample Research Notes Requests

Quick Navigation

• Resources
• Methods
• URI Parameters

Resources

Resource Name	Description	Availability
		public	partner	premium partner	espn
/sports	All available sports/sections
/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/football/college-football	NCAA College Football
/sports/football/nfl	National Football League (NFL)
/sports/hockey/nhl	National Hockey League (NHL)

Methods

Method	Description	Availability
		public	partner	premium partner	espn
/news/notes	Retrieves the latest notes.
/news/notes/:id	Retrieves data associated with a specific note.
/athletes/:athleteId/news/notes	Retrieves notes about a particular athlete.
/teams/:teamId/news/notes	Retrieves notes about a particular team.
/events/:eventId/news/notes	Retrieves notes about a particluar event.

URI Parameters

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

Parameter	Value & Description	Availability
		public	partner	premium partner	espn
dates	Integer in the form of "yyyymmdd" to get research notes for a particular date. Not applicable when requesting individual research note information or event-specific research notes.

Quick Navigation

• Returned Data
• Sample Response

Returned Data

Element	Description	Availability
		public	partner	premium partner	espn
headline	Headline for the research note.
id	Unique ID for the note in ESPN's publishing system.
text	Full note content.
source	The news source, e.g. ESPN Stats and Information.
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).
date	The date the note was published.
type	The type of note published. For this API will always be "research".

Sample Response

Sample Code