ESPN Research Notes Data

Research Notes

The holy grail of sports trivia
  • The ESPN Research Notes API allows you to tap into ESPN's vast knowledgebase of exclusive sports data tidbits compiled by our Stats and Information Group. Research Notes are available by sport, athlete, team, and even game.

    This API is currently a version 1 (/v1/) release.

    Availability
    Public Strategic Partner ESPN
  • 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

    Action URI Description
    GET http://api.espn.com/v1/sports/news/notes Get the latest research notes from ESPN across all supported sports.
    GET http://api.espn.com/v1/sports/basketball/nba/news/notes Get the latest notes for the NBA.
    GET http://api.espn.com/v1/sports/baseball/mlb/athletes/3748/news/notes Get research notes for a particular MLB player.
    GET http://api.espn.com/v1/sports/basketball/nba/teams/13/news/notes Get research notes for a particular NBA team.
    GET http://api.espn.com/v1/sports/baseball/mlb/news/notes?limit=3 Get the latest 3 research notes about MLB.
    GET http://api.espn.com/v1/sports/basketball/nba/news/notes/13200038 Get a specific NBA research note.
  • Quick Navigation

    Resources

    Resource Name Description Availability
    public strategic
    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)
    Back to top

     

    Methods

    Method Description Availability
    public strategic
    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.
    Back to top

     

    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 strategic
    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.
    Back to top

     

  • Quick Navigation

    Returned Data

    Element Description Availability
    public strategic
    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).
    uid A globally unique string identifier for the sports entity in ESPN's systems.
    date The date the note was published.
    type The type of note published. For this API will always be "research".
    Back to top

     

    Sample Response

    XML

    The following XML output was rendered with an internal key calling:
    http://api.espn.com/v1/sports/news/notes?limit=5&_accept=text/xml&apikey=:yourkey.

     

    JSON

    The following JSON output was rendered with an internal key calling:
    http://api.espn.com/v1/sports/news/notes?limit=5&apikey=:yourkey.

    Back to top
  • Sample Code

    JavaScript