ESPN Now Content Stream

ESPN Now

When you can't decide, get the sampler
  • The ESPN Now API allows you to tap into a stream of the latest content published on ESPN.com, including headline news, stories, columns, blogs, videos, podcasts, game recaps, and more. There's no better way to know what's happening in the world of sports, right NOW.

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

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

    Action URI Description
    GET http://api.espn.com/v1/now Stream of the latest, most-recently published content on ESPN.com.
    GET http://api.espn.com/v1/now/top Top editorially-curated content on ESPN.com.
    GET http://api.espn.com/v1/now/popular Most popular, recently published content on ESPN.com.
    GET http://api.espn.com/v1/now?leagues=nfl&teams=4 Most recent content for a particular NFL team.
  • Quick Navigation

    Resources

    Resource Name Description Availability
    public strategic
    partner
    espn
    /now Stream of the latest content published on ESPN.com.
    Back to top

     

    Methods

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

     

    URI Parameters

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

    Parameter Value & Description Availability
    public strategic
    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
    groups Comma-separated list of groups (conference IDs) to filter by. Only applicable when used in conjunction with the mens-college-basketball, womens-college-basketball, or college-football leagues value. Note: Currently this param only accepts a single value.
    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. Not applicable with teams or leagues parameters. Supported content type filters are below:
    alert All alerts
    blog
    elias Research notes provided by Elias
    game All game alerts
    gamefinal Game final alerts
    gameperiod Game period start alerts
    gamescore Game scoring alerts
    gamestart Game start alerts
    podcast
    story
    tweet Relevant ESPN-approved tweets
    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.
    lang Can be used to return content in the specified language. Supported languages are below. Note: not all content is available in multiple languages and will return in English if no alternative is available.
    en English. Default language.
    es Spanish
    region Can be used in conjunction with the lang query string parameter to return focused content for a particular region, where available. Current supported regions are listed below:
    gb Great Britain. Only applicable with the leagues=soccer and teams parameters set.

    Back to top

     

  • Quick Navigation

    Returned Data

    Requests to the ESPN Now API return the following data:

    Element Description Availability
    public strategic
    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).
    uid - A globally unique string identifier for the sports entity in ESPN's systems.
    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.
    Back to top

     

    Sample Response

    XML

    The following XML output was rendered with a public developer key calling:
    http://api.espn.com/v1/now?limit=3&_accept=text/xml&apikey=:yourkey.

     

    JSON

    The following JSON output was rendered with a public key calling:
    http://api.espn.com/v1/now?limit=3&apikey=:yourkey.

    Back to top