Sports news API

Recent league or team headlines with description, publish time, images and tagged teams and athletes. An archive endpoint returns older articles. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.

Paths and parameters

GET/api/v1/sports/{sport}/leagues/{league}/news

Get latest news. Rolling window of recent articles from the source. For older articles use /news/history.

  • sport (path, required): Sport slug: football, basketball, baseball, hockey, soccer.
  • league (path, required): League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1.
  • limit (query): Maximum articles to return (default 10, max 50).
  • page (query): Page number (1-based).
  • team (query): Filter to one team id.
  • athlete (query): Only articles tagged with this athlete id.
  • since (query): Alias of `from`.
  • from (query): Only items on or after this ISO-8601 timestamp.
  • to (query): Only items on or before this ISO-8601 timestamp.

GET/api/v1/sports/{sport}/leagues/{league}/news/history

Get archived news. Our archive of league news, newest first. The archive begins 2026-09-02.

  • sport (path, required): Sport slug: football, basketball, baseball, hockey, soccer.
  • league (path, required): League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1.
  • from (query): Only items on or after this ISO-8601 timestamp.
  • to (query): Only items on or before this ISO-8601 timestamp.
  • team (query): Filter to one team id.
  • athlete (query): Only articles tagged with this athlete id.
  • limit (query): Maximum articles to return (default 25, max 100).
  • page (query): Page number (1-based).

Live example

Request

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/news?limit=1"

Response captured from live data at 2026-11-21 21:32 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key.

Response

{
  "success": true,
  "data": [
    {
      "id": 50530832,
      "headline": "Fantasy football Week 11 inactives: Who's in and who's out?",
      "description": "Updated inactives and analysis based on the latest reports and official announcements leading up to kickoff.",
      "type": "Story",
      "published": "2026-11-21T20:32:44Z",
      "lastModified": "2026-11-21T20:32:44Z",
      "premium": false,
      "images": [
        {
          "url": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHUcMXhFXTQcEUwAfQ0JTCl8HU1tdWxtYUGVDBgxBVQFXbQZSHFwWCEVT",
          "caption": "With a quick turnaround to Thanksgiving, the Chiefs are likely to rest Kenneth Walker III this weekend.",
          "width": 576,
          "height": 324
        },
        {
          "url": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHUcMXhFXTQcEUwAfQ0JTCl8HU1tdWxtYV2VDBgxBVQFXbQZSHFwWCEVT",
          "caption": "If T.J. Hockenson suits up on Sunday night, he'll be a solid TE option in fantasy.",
          "width": 576,
          "height": 324
        },
        {
          "url": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMMEF0HCV8SWFsUBVcNHFYPUAhZC09RBRheFwdOXwMFDEMEBkkABRUVXldUCV1MAAdWB0oJUwcETkVDLUFRCEZEU15ZPBxYVApGBgsBUGxQBQJUCFwJTUZHPgQAQEVQC0JFPV1YUx1ZUwtOB2UKUQZTCw5VHw9IBQ",
          "caption": "Yates, Clay disagree over Ollie Gordon II in Week 11",
          "width": 576,
          "height": 324
        }
      ],
      "link": "https://www.realtimesportsapi.com/api/go?id=GgcVSgNPTUMeFFpHAUkGXxRaCV5MVFYKRQRLGxpSDllEEBINVl8GFgMbGgI2S0oXVl8WIHUwR1kAUBxxDFRXFV9GFwBMD0BAUVxRUB9GAlsYRVtKHx4FXVgQUwRUDhhdD1xFABoESV0bBABEFEgMDxdHABdQCFIARl4SVEhZAUFdF1M",
      "categories": [
        "news - fantasy",
        "news - fantasy football",
        "Fantasy NFL",
        "... 3 more"
      ],
      "athletes": [],
      "teams": []
    }
  ],
  "meta": {
    "count": 1,
    "note": "The provider feed is a rolling window of recent articles; use /news/history for older ones.",
    "rateLimit": {
      "limit": 125,
      "remaining": 124,
      "reset": 1796083200000
    }
  }
}

Fields

FieldTypeNotes
idinteger
headlinestring
descriptionstring
typestring
publishedstring
lastModifiedstring
premiumboolean
imagesobject[]
linkstring
categoriesstring[]
athletesobject[]
teamsobject[]

League support

Checked against live data on 2026-10-04: 29 available, 0 limited, 0 seasonal or not verified, 0 not available.

Code samples

curl

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/news?limit=1"

JavaScript (fetch)

const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/news?limit=1", {
  headers: { Authorization: `Bearer ${process.env.RSA_API_KEY}` }
});
const { success, data, meta } = await res.json();
console.log(data, meta.rateLimit);

Python (requests)

import os, requests

res = requests.get(
    "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/news?limit=1",
    headers={"Authorization": f"Bearer {os.environ['RSA_API_KEY']}"},
    timeout=10,
)
body = res.json()
print(body["data"])

MCP prompt (Claude, Cursor, ChatGPT)

Using the Realtime Sports MCP server (https://www.realtimesportsapi.com/api/mcp), call get_news with sport "football" and league "nfl" and summarize the latest headlines for NFL.

Connect the hosted MCP server first: setup guide. Each tool call counts as one API call.

Each request above is 1 call. Free covers 125 calls a month after a 1,000-call first month, at 1 request/second. Starter is $29/month for 10,000 calls (about 333 a day) plus webhooks and WebSocket, so you stop polling for changes; 7-day free trial. Compare plans

Shipping a product with this data?

Polling works on every plan. Production apps usually also want events pushed to them, by webhook or WebSocket, as soon as we detect them (typically 20-30 seconds behind live play). These guides show the setup and the plan each one needs.

Guides

Rate limits and pricing

PlanPriceCallsRateWebSocketWebhooks
Free$0125/mo (1,000 first 30 days)1/s500 msgs/moNo
Starter$29/mo ($290/yr)10,000/mo5/sShares monthly poolShares monthly pool
Growth$49/mo ($490/yr)25,000/mo10/sShares monthly poolShares monthly pool
Pro$99/mo ($990/yr)50,000/mo20/s100,000 msgs/mo25,000/mo
Business$179/mo ($1,790/yr)150,000/mo40/s300,000 msgs/mo75,000/mo
Scale$299/mo ($2,990/yr)500,000/mo100/s500,000 msgs/mo100,000/mo

Every successful REST call counts as one call. Over the limit you get HTTP 429 with a Retry-After header. No SLA. Full pricing.

FAQ

What does the news endpoint return?
Recent league or team headlines with description, publish time, images and tagged teams and athletes. An archive endpoint returns older articles.
Which leagues support news?
All 29 monitored leagues returned data when we checked on 2026-10-04.
Is it free to try?
Yes. The Free plan is $0 with 125 calls per month (1,000 in the first 30 days) at 1 request per second, no card required. Every successful call counts as one call.
How fresh is the data?
Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.
Can I get updates pushed instead of polling?
Webhooks are included on every paid plan (Starter, Growth, Pro, Business, Scale). WebSocket is included on paid plans, and the Free plan gets a 500-message monthly preview.