ESPN API Explorer

• Sports API

  • List Methods
  • Expand Methods

  • GET Sports /sports/:sportName/:leagueName/
    Sports and leagues supported in the ESPN API.

    Parameter	Value	Type	Description
    :sportName	All Sports Baseball Basketball Boxing Football Golf Hockey Horse Racing MMA Olympics Racing Soccer Tennis	fixed	Sport name
    :leagueName	All Leagues	string	League / organizing body within the sport.
    _accept	application/json text/xml	string	Payload output format

• Headlines API

  • List Methods
  • Expand Methods

  • GET Headlines /:newsSection/:sportName/:leagueName/news/:method/:headlineId
    Latest sports news and analysis from ESPN.

    Parameter	Value	Type	Description
    :newsSection	Sports (Default) ESPN City Sites ESPNW Fantasy ESPN Magazine	fixed	News section
    :sportName	All Sports Baseball Basketball Boxing Football Golf Hockey Horse Racing MMA Olympics Racing Soccer Tennis X Games	fixed	Sport name
    :leagueName	All Leagues	string	League / organizing body within the sport.
    :method	All Stories Editor-Selected Stories Top Sports Stories	string	Type of stories to retrieve.
    :headlineId		integer	ID of specific story to retrieve.
    dates		date (yyyymmdd)	Used to retrieve stories from a specific date, in YYYYMMDD format.
    teams		string	Retrieve stories about a particular team (teamId)
    athletes		string	Retrieves stories about a particular player/athlete (athleteId)
    events		string	Retrieves stories about a particular event (eventId)
    enable		string	Comma separated list of node names to enable. Currently supports 'inlines' (access tier permitting).
    disable		string	Comma separated list of node names to disable. Currently supports these values: audio, categories, keywords, mobileStory, related, and story.
    insider	Include Insider Content Exclude Insider Content Only Include Insider Content	string	Toggles whether or not to include premium (ESPN Insider) content.
    lang	English (Default) Spanish	string	Language to receive content in.
    region	US (Default) Argentina Columbia Great Britain Mexico	string	Region of editorial focus. Only applicable for soccer and spanish language content.
    limit		integer	Limits the number of results returned.
    offset		integer	Offset from zero of where to start results.
    _accept	application/json text/xml	string	Payload output format

• Athletes API

  • List Methods
  • Expand Methods

  • GET Athletes /sports/:sportName/:leagueName/athletes/:athleteId
    Athlete stats and information from ESPN.

    Parameter	Value	Type	Description
    :sportName	Baseball Basketball Football Golf Hockey Racing Soccer Tennis	fixed	Sport name
    :leagueName	Major League Baseball	string	League / organizing body within the sport.
    :athleteId		integer	Specific athlete ID.
    groups		integer	Used to specify a specific group or division within the league/organizing body.
    enable		string	Comma separated list of node names to enable. Currently supports stats, logos, flags, notes, and competitors, subject to access tier.
    lang	English (Default) Spanish	string	Language to receive content in.
    limit		integer	Limits the number of results returned.
    offset		integer	Offset from zero of where to start results.
    _accept	application/json text/xml	string	Payload output format.

• Teams API

  • List Methods
  • Expand Methods

  • GET Teams /sports/:sportName/:leagueName/teams/:teamId
    Sports team stats and information from ESPN.

    Parameter	Value	Type	Description
    :sportName	Baseball Basketball Football Hockey	fixed	Sport name
    :leagueName	Major League Baseball	string	League / organizing body within the sport.
    :teamId		integer	Specific team ID.
    enable		string	Comma separated list of node names to enable. Currently supports venues, stats, roster, and leaders, subject to access tier.
    groups		integer	Used to specify a specific group or division within the league/organizing body.
    rostertype	Default Full Team Roster Active Team Roster	string	Can be used to specify full or active roster. Only applicable to MLB. Subject to access tier.
    dates		date (yyyy)	Used to retrieve members of the team for a particular year, in YYYY format.
    lang	English (Default) Spanish	string	Language to receive content in.
    limit		integer	Limits the number of results returned.
    offset		integer	Offset from zero of where to start results.
    _accept	application/json text/xml	string	Payload output format.

• ESPN Now API

  • List Methods
  • Expand Methods

  • GET Now /now/:method
    Stream of the latest content published on ESPN.com .

    Parameter	Value	Type	Description
    :method	Most Recent (Default) Top Content Most Popular Content	fixed	Type of content to retrieve.
    leagues	mens-college-basketball mlb mma nascar nba nfl nhl olympics racing soccer tennis wnba womens-college-basketball	string	String denoting a particular sport category or sports league/organizing body. Not applicable to /top and /popular methods.
    content	All Content Video Content Only	string	Content types to retrieve. Not applicable to /top and /popular methods.
    teams		string	Retrieve content about a particular team (teamId). Not applicable with /top and /popular methods.
    _accept	application/json text/xml	string	Payload output format.

• Standings API

  • List Methods
  • Expand Methods

  • GET Standings /sports/:sportName/:leagueName/standings
    The latest league and divisional standings from ESPN.

    Parameter	Value	Type	Description
    :sportName	Baseball Basketball Football Golf Hockey Racing Soccer Tennis	fixed	Sport name
    :leagueName	Major League Baseball	string	League / organizing body within the sport.
    enable		string	Comma separated list of node names to enable. Currently supports logos, subject to access tier.
    groups		integer	Used to specify a specific group or division within the league/organizing body.
    dates		date (yyyy)	The year to retrive standings for. Defaults to current year.
    seasontype	Default Preseason Regular Season Postseason	string	Value corresponding to either preseason, regular season, or postseason games. Accepts string (pre/reg/post) values.
    flat	Default Flat Output	boolean	Returns a flattened result set in order to show all teams ranked from first to last without breaking them out into divisions. Only valid with team-based sports.
    lang	English (Default) Spanish	string	Language to receive content in.
    limit		integer	Limits the number of results returned.
    offset		integer	Offset from zero of where to start results.
    _accept	application/json text/xml	string	Payload output format.

• Research Notes API

  • List Methods
  • Expand Methods

  • GET Research Notes /sports/:sportName/:leagueName/news/notes/:noteId
    Exclusive factoids produced by ESPN's Stats and Information Group.

    Parameter	Value	Type	Description
    :sportName	All Sports Baseball Basketball Football Hockey	fixed	Sport name
    :leagueName	All Leagues	string	League / organizing body within the sport.
    teams		integer	Retrieve notes about a particular team (teamId).
    athletes		integer	Retrieve notes about a particular athlete (athleteId).
    events		integer	Retrieve notes about a particular event (eventId).
    :noteId		integer	Retrieve content for a specific note.
    dates		date (yyyymmdd)	Retrieve notes for a specific date in YYYYMMDD format.
    limit		integer	Limits the number of results returned.
    offset		integer	Offset from zero of where to start results.
    _accept	application/json text/xml	string	Payload output format

• Medals API

  • List Methods
  • Expand Methods

  • GET Medals /sports/olympics/medals
    Medal counts and competition information from the Olympic Games.

    Parameter	Value	Type	Description
    dates		date (yyyy)	The year of the Olympic Games in YYYY format.
    season		string	The season of the Olympic Games. Supported values are summer or winter.
    enable		string	Comma separated list of node names to enable. Currently supports flags and competition information (including final scores), subject to access tier.
    lang	English (Default) Spanish	string	Language to receive content in.
    limit		integer	Limits the number of results returned.
    offset		integer	Offset from zero of where to start results.
    _accept	application/json text/xml	string	Payload output format.

• Audio API

  • List Methods
  • Expand Methods

  • GET Audio /audio/:method/:podcastId/:recordingId
    Audio podcasts and clips from ESPN.

    Parameter	Value	Type	Description
    :method	Podcasts (Shows) Audio Recordings (Clips) Podcast-Specific Audio Recordings	string	Audio content to grab.
    :podcastId		integer	Specific Podcast ID.
    :recordingId		integer	Specific audio recording (clip) ID.
    insider	Include Insider Content Exclude Insider Content Only Include Insider Content	string	Toggles whether or not to include premium (ESPN Insider) content.
    _accept	application/json text/xml	string	Payload output format.

• Video API

  • List Methods
  • Expand Methods

  • GET Video /video/channels/:categoryId/clips/:clipId
    Video clip and channel information from ESPN.

    Parameter	Value	Type	Description
    :categoryId		integer	Specific video channel ID.
    :clipId		integer	Specific video clip ID.
    _accept	application/json text/xml	string	Payload output format.

• Score & Schedules API

  • List Methods
  • Expand Methods

  • GET Events /sports/:sportName/:leagueName/events/:eventId
    Returns schedule and scores information.

    Parameter	Value	Type	Description
    :sportName	All Sports Baseball Basketball Football Golf Hockey MMA Olympics Racing Soccer Tennis	fixed	Sport name
    :leagueName	All Leagues	string	League / organizing body within the sport.
    :eventId		integer	Specific event ID.
    seasontype		string	Value corresponding to either preseason, regular season, or postseason games. Accepts string (pre/reg/post) values. If not passed will default to the season type corresponding to the current date. Not applicable to golf, tennis, or racing.
    weeks		integer	Integer. Only applicable to college and NFL football. When used with dates parameter, returns games for that particular week.
    enable		string	Comma separated list of node names to enable. Currently supports odds, logos, broadcasts, flags, weather, series,and ranks, subject to data availability and method being used.
    disable		string	Comma separated list of node names to disable. Currently supports links, venues, stats, season, sports, leagues, team, athletes, and linescores, subject to data availability and method being used.
    dates		date (yyyymmdd)	Retrieve notes for a specific date in YYYY, YYMM, or YYMMDD format, subject to data availability and method being used.
    lang	English (Default) Spanish	string	Language to receive content in.
    _accept	application/json text/xml	string	Payload output format