RecipesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

News

Provides the latest news content for a given sport and league. Articles will include statistics, quotes, injuries, and transactions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Data Points

Content
AttributeParent ElementTypeDescription
end_timecontentStringEnd time of the daily news manifest

ex. 2023-02-21T23:59:59+00:00
start_timecontentStringStart time of the daily news manifest

ex. 2023-02-21T00:00:00+00:00
leaguecontentStringName of league for a manifest

ex. epl (Enlish Premier League)
manifest_datecontentStringTimestamp of the most recent published update to a manifest
providercontentStringNews provider for a manifest

ap (Associated Press), ap_premium (Associated Press Premium)
sportcontentStringName of sport or league for a manifest

ex. soccer or nfl
long_htmlitem - contentStringContent of an editorial item in HTML format
longitem - contentStringContent of an editorial item
Item
AttributeParent ElementTypeDescription
bylineitemStringByline for an editorial item

ex. By STEVE REED, AP Sports Writer
createditemStringTimestamp of a creation of an editorial item

ex. 2023-02-21T20:20:11+00:00
credititemStringCredit for an editorial item

ex. AP
datelineitemStringDateline for an editorial item

ex. CHARLOTTE, N.C.
iditemGUIDUnique ID of an editorial item

ex. 0d46205d-8252-420b-9f27-e4c9cfc699fb
injuryitemBooleanSignifies the editorial item is an injury update
titleitemStringTitle (or headline) of an editorial item

ex. <![CDATA[Titans hire Jason Outten as running backs coach]]>
transactionitemBooleanSignifies the editorial item is a transaction update
typeitemStringType of editorial item

ex. news, preview, recap
updateditemStringTimestamp of an update to an editorial item

ex. 2023-07-04T14:56:25+00:00
Assets

Note: Supplementary images are only present for Premium Editorial Content

AttributeParent ElementTypeDescription
idassetGUIDUnique ID of an image

ex. 0de668e5-c3a8-4ed5-88e9-2a99a4be98e9
createdassetStringTimestamp of a creation of an image

ex. 2022-02-14T03:08:00+00:00
descriptionassetStringText description of an image

ex. <![CDATA[Los Angeles Rams wide receiver Cooper Kupp, top, catches a touchdown against Cincinnati Bengals cornerback Eli Apple during the second half of the NFL Super Bowl 56 football game Sunday, Feb. 13, 2022, in Inglewood, Calif. (AP Photo/Marcio Jose Sanchez)]]>
titleassetStringTitle (or headline) of an image

ex. <![CDATA[APTOPIX Rams Bengals Super Bowl Football]]>
updatedassetStringTimestamp of an update to an image

ex. 2022-02-14T03:08:14+00:00
Links

Note: Supplementary images are only present for Premium Editorial Content

AttributeParent ElementTypeDescription
heightlinkIntegerHeight in pixels of an image

ex. 3082
hreflinkStringHypertext reference used to create a downloadable URL to an image

ex. /assets/2022/2/13/0de668e5-c3a8-4ed5-88e9-2a99a4be98e9/original.jpg
widthlinkIntegerWidth in pixels of an image

ex. 4622
Reference
AttributeParent ElementTypeDescription
namerefStringName of an editorial item entity (eg. event, player, team)

ex. BAL at NYY (MLB - 7/4/2023) (event), Baltimore Orioles (organization), Schmidt, Clarke (profile)
typerefStringEditorial item type (eg. event, player, team)

profile, organization, event, venue, tournament, season
sportrefStringSport or league of an editorial item

ex. nfl, mlb or soccer
sportradar_idref - entity_idGUIDUnique Sportradar ID of an editorial item

ex. 07f4f1e1-8eff-4988-a4bf-e35f13d6327b
sportsdata_idref - entity_idGUIDUnique SportsData ID of editorial item. This ID is typically only used as an extra identifier for teams within the NFL or NCAA Football APIs

ex. CHI (Chicago Bears)
Reference Entities
AttributeParent ElementTypeDescription
alt_idref - entity_idGUIDUnique SportsData ID used to link editorial item to a type (eg. event, player, team). This ID is typically only used as an extra identifier for teams within the NFL or NCAA Football APIs

ex. CHI (Chicago Bears)
idref - entity_idGUIDUnique Sportradar ID used to link editorial item to a type (eg. event, player, team)

ex. 20ef56e1-8c82-4f96-84b0-3ce79f1a1a31 or sr:match:33623381
originref - entity_idStringSource of the unique Sportradar ID used to link editorial item to a type (eg. event, player, team)

SR = Sportradar General Sport IDs such as sr:match:33623381; SD = Sportradar League Specific IDs such as 20ef56e1-8c82-4f96-84b0-3ce79f1a1a31
sportref - entity_idStringSport or league of a source ID

ex. nfl, mlb or soccer
Provider
AttributeParent ElementTypeDescription
provider_content_idproviderStringProvider asset ID

ex. 8bf72b9405c78761d3618cd11c4b12c3
nameproviderStringNews provider for an editorial item

ap (Associated Press), getty (Getty), reuters (Reuters), usat (USA Today)
original_linkproviderStringOriginal URL of an editorial item
original_publishproviderStringOriginal publish timestamp of an editorial item

ex. 2023-07-05T01:35:33+00:00
versionproviderStringProvider version number of an editorial item. Number will update when a change is made to the content by our provider.
Path Params
string
enum
required
Defaults to nfl

Abbreviation for the specified sport or league

f1, golf, indycar, mlb, nascar, nba, nbdl, ncaafb, ncaamb, ncaawb, nfl, nhl, olympics, soccer, tennis, wnba

Include the league parameter for soccer requests

string
enum
required
Defaults to t

The access level of your API key

t (Trial), p (Production)

Allowed:
string
enum
required
Defaults to ap

News provider

ap (Associated Press), ap_premium (Associated Press Premium)

Note: Premium includes image assets linked within the articles

Allowed:
string
enum
required

Only required for Soccer. Defines the requested soccer league.

Leagues include:
epl (English Premier League), la-liga (La Liga), la-liga-women (Women's La Liga), mls (MLS), uefa-champions-league (UEFA Champions League), uefa-champions-league-women (Women's UEFA Champions League), intl-soccer (International), intl-soccer-women (Women's International), wsl (Women's Super League)

int32
required
Defaults to 2025

Year in YYYY format

string
enum
required
Defaults to 01

Month in MM format

string
enum
required
Defaults to 14

Date in DD format

string
enum
required
Defaults to all

Type of news returned.

all, injuries, transactions

Allowed:
string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json