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
    content Optional flag to filter results by content type, with the following options. Accepts a single value or a comma-delimited string of values. For example, "content=story,tweet". Supported content types include the following:
    alert All alerts
    blog ESPN blog entries.
    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.
    graphic Featured ESPN TV graphics.
    podcast Featured ESPN Radio and podcast clips.
    social All relevant social media content, including Twitter and Instagram.
    story Featured news stories.
    tweet Relevant ESPN-approved tweets.
    video Featured ESPN video clips.
    days Optional parameter to filter results back by a specified number of days. Takes an integer value. For example, "days=3".
    defaultsort Optional parameter to filter results back by a specified number of days. Takes an Boolean value. When "defaultsort=true", content is sorted by published date (date when content is created in CMS). When "defaultsort=false", content is sorted by curated date (date when content is added to contentlink).
    disable Optional flag to disable specific information, with the following options. Accepts a single value or a comma-delimited string of values. For example, "disable=breakingnews,metrics".
    breakingnews Disables the breakingNews property.
    metrics Disables the metrics array.
    categories Disables the categories array, if it exists for the story.
    enable Optional flag to enable specific information, with the following options:
    authors Returns an array of author information for the content, when available.
    headshots Returns links to player headshots in various sizes for "athlete" type objects in the categories array. Use in conjunction with the headshotsize parameter to return specific image sizes.
    inlines Returns an array of objects containing HTML markup for inline tables, when available.
    logos Returns links to team logo images in various sizes for "team" type objects in the categories array. Use in conjunction with the logosize parameter to return specific image sizes.
    newsstack Returns a newsStack array of story objects when used with the "newsfeed=true" parameter.
    peers Returns additional image sizes in a peers array within an image object, when available. Use the peerimagesizes parameter to filter which sizes are returned.
    story Returns a story key, the value of which is a string containing the content of the news item.
    groups Optional flag to filter results by specific groups (conference IDs). Only applicable when used in conjunction with the leagues parameter and mens-college-basketball, womens-college-basketball or college-football value. Note: Currently this parameter accepts a single value only. For example: "leagues=college-football&groups=9".
    headshotsize Returns a specific headshot images size when the "enable=headshots" parameter is used. Accepts a single value. For example, "enable=headshots&headshotsize=large". Supported sizes include full (600×436), xlarge (350×254), large (65×90), medium (43×60), small (34×48), xsmall (28×38), fantasy (200×145) and gamecast (120×90).
    lang Optional flag to return content in the specified language. Note: not all content is available in multiple languages and will return in English if no alternative is available. Supported values include the following:
    en English. Default language.
    es Spanish.
    leagues Optional flag to filter results by sport category or sports league/organizing body. Not applicable to /top and /popular methods. Note: Currently this parameter accepts a single value only. Supported values include the following:
    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
    logosize Specifies the image size to return for team logos, when the "enable=logos" parameter is set. Supported sizes include full (110×110), medium (80×80), small (50×50), xsmall (40×40) and xxsmall (25×25).
    newsfeed Optional Boolean flag used in conjunction with the "enable=newsstack" parameter to return a newsStack array of story objects. For example, "newsfeed=true".
    nowID Optional flag used to request a specific content object. Takes the entity type ID and content ID separated by a hyphen in the format entityTypeID-contentID. For example, "nowID=21-491339963070705664".
    peerimagesizes Optional flag to filter returned image sizes when the "enable=peers" parameter is used. Accepts a string value representing the desired image size. For example, "enable=peers&peersimagesizes=110x110,1296x1296".
    region Optional flag used in conjunction with the lang parameter to return focused content for a particular region, where available. Supported regions include the following:
    gb Great Britain. Only applicable with the leagues=soccer and teams parameters set.
    teams Optional flag used in conjunction with the leagues parameter to filter results by team ID. Not applicable to /top and /popular methods. Note: Currently this param only accepts a single value.
    videolimit Limits the number of videos returned to the number specified. Accepts an integer value.
    _ceID Returns content from a specific CE collection. Accepts an integer CE ID value.
    _pinnedID Returns pinned content from a specified feed collection. Accepts an integer ID value of the collection object containing the pinned contents.

    Back to top

     

  • Quick Navigation

    Returned Data

    Requests to the ESPN Now API return story data in a feed: array and, optionally, a newsStack: array if the "enable=newsstack&newsfeed=true" parameters are used. Both arrays contain the following core properties:

    Element Description Availability
    public strategic
    partner
    espn
    headline String headline for the content.
    lastModified Timestamp indicating the last time the story was updated.
    premium Boolean indicating whether the story is premium ESPN Insider content.
    isPinned Boolean indicating whether the story is from a pinned content feed. Returned only when the _pinnedID parameter is specified.
    links Object containing platform-optimized links to the content, if available. See the Links Object for details.
    type String description of the content type, according to ESPN's publishing classifications.
    section String notation of the site section the content was published in. Not always returned depending on content type.
    inlines Array of objects containing markup for inline tables. Returned only when the "enable=inlines" parameter is used. See the Inlines Object for details.
    related Array containing related content objects. See the Related Object for details.
    id Integer content ID for the content item.
    authors Array containing information about the authors of an story, when available and the "enable=authors" parameter is used. See the Authors Object for details.
    story String containing the content of the story item with HTML markup. Returned when the "enable=story" parameter is used.
    byline String author attribution for the story. Not applicable to all content.
    linkText Short text suitable for use in HTML anchor tags. Not applicable to all content.
    categorized Timestamp indicating when content was added to contentlink. Used for sorting by curated time in conjunction with the defaultsort parameter.
    source String description of the news source. For example, "ESPN The Magazine". Not applicable to all content.
    metrics Array of 'metrics' objects, each containing the following properties: type provides a string description of the metric. Possible values include "views", "fShares", "tweets", "comments", "emails", "votes", and "popularity". count provides an integer value for the metric.
    description String containing a 1-2 sentence summary/tease of the content.
    images Array of objects containing images related to the story, when available. See the Images Object for details.
    categories Array of objects containing keyword metadata related to the story. See the Categories Object for details.
    published Timestamp indicating when the story was first published.
    video Array of video objects. See the Video API for details. Not applicable to all content.
    blogName String corresponding to the blog the content was published in, if the content type is a blog entry.
    title String meta title of the content.
    Back to top

    Authors Object

    Element Description Availability
    public strategic
    partner
    espn
    firstName First name of the author.
    lastName Last name of the author.
    displayName Full first and last name of the author.
    shortName First initial and last name of the author.
    twitterUserName String containing the Twitter handle for the author. For example, "@CraigCustance".
    biography String containing brief biographical notes about the author. May contain inline HTML markup.
    sourceLine String description of author's publisher or expertise.
    images Array of objects containing headshots for the author. See the Images Object for details.
    links Object containing a link to the author's profile page on the ESPN web site.
    Back to top

    Categories Object

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of the category.
    description String description of the related topic. For example, "College Football".
    type String description of the category type. Possible values include "sport", "team", "league", or "athlete".
    sportId Integer ID of the related sport.
    leagueId Integer ID of the related league, when the type is "league".
    league Object containing the id and description properties along with links for league content, when the type is "league".
    uid A globally unique string identifier for the sports entity in ESPN's systems.
    teamId Integer ID of the related team, when the type is "team".
    team Object containing id and description properties along with links for team content, when the type is "team".
    athleteId Integer ID of the related athlete, when the type is "athlete".
    athlete Object containing id and description properties along with links for athlete content, when the type is "athlete".
    Back to top

    Images Object

    Element Description Availability
    public strategic
    partner
    espn
    height Integer indicating image height in pixels.
    alt String specifying ALT text, if available.
    width Integer indicating image width in pixels.
    name String title for the image.
    caption String caption for the image, if available.
    type String indicating the type of image.
    credit String containing copyright information associated with the image.
    url The URL for the image.
    peers Array of objects containing alternate sizes for the image, if available. Enabled when the "enable=peers" parameter is used. Filter results by size with the peerimagesizes parameter. Objects included in the array follow the same key-value pattern as other Images objects.
    Back to top

    Inlines Object

    The inlines array contains markup for inline content elements such as pullquotes. Included in the response when the "enable=inlines" parameter is used. The array may include zero or more objects that contain the following properties. body and type are included for all inline objects. Objects of type "Module" may contain additional properties.

    Element Description Availability
    public strategic
    partner
    espn
    body String containing the content. May include inline HTML markup.
    byline String attribution for the content.
    moduleType String description of the content's intended use. For example, "pullquote".
    images Array of objects containing images related to the story, when available. See the Images Object for details.
    categories Array of objects containing keyword metadata related to the inline content. See the Categories Object for details.
    type String describing the type of markup. For example, "BareHTML".
    Back to top
    Element Description Availability
    public strategic
    partner
    espn
    api Object containing links to related API calls for the content.
    web Object containing URLs for web-optimized content.
    mobile Object containing URLs for mobile-optimized content.
    app Object containing URLs for an app-related feed for the content.
    source Object containing URLs for various non-optimized, source content formats. Typically associated with video content.
    Back to top
    Element Description Availability
    public strategic
    partner
    espn
    id Integer content ID for the related story.
    headline String headline for the related story.
    title String meta title of the content.
    linkText Short text suitable for use in HTML anchor tags.
    premium Boolean indicating whether the related story is premium ESPN Insider content.
    description String description or lede for related story.
    images Array of objects containing images related to the story, when available. See the Images Object for details.
    links Object containing platform-optimized links to the content, if available. See the Links Object for details.
    type String description of the content type.
    Back to top

     

    Sample Response

    JSON

    The following JSON output was rendered with a public key calling:
    http://api.espn.com/v1/now?limit=2&enable=inlines,authors&disable=breakingnews&apikey=:yourkey.

    Back to top