MLS API

Realtime Sports API serves MLS games through the same REST endpoints and JSON schema as every other league, using sport=soccer and league=usa.1. You get the current scoreboard, live scores, game detail, play-by-play, teams, rosters and news, plus current odds and line history from a single source book. Not currently available or not verified for this league: injuries, player box-score stats. 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.

Slugs
sport=soccer
league=usa.1
Teams
32
Season (from data)
2026 MLS Eastern Conference Playoffs - Round One
In the scoreboard now
3 games

Upcoming and live MLS games

MLS games from the API
DateAwayHomeTime / ResultTVVenue
Sat, Nov 21Philadelphia UnionatNew England Revolution2:00 PM ETTV: Apple TVGillette Stadium · Foxborough, Massachusetts
Sat, Nov 21Portland TimbersatFC Dallas4:00 PM ETTV: Apple TVToyota Stadium · Toyota Stadium
Sat, Nov 21Columbus CrewatInter Miami CF6:00 PM ETTV: Apple TVNu Stadium · Miami, Florida

From the /events endpoint for this league, refreshed every few minutes. Times are US Eastern. Full MLS schedule · MLS team APIs · Free MLS scoreboard widget

Live example

Request

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

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

Response

{
  "success": true,
  "data": [
    {
      "id": "401933733",
      "uid": "s:600~l:770~e:401933733",
      "name": "Philadelphia Union at New England Revolution",
      "shortName": "PHI @ NE",
      "date": "2026-11-21T19:00Z",
      "status": {
        "state": "pre",
        "completed": false,
        "period": 0,
        "clock": "0'",
        "detail": "Sat, November 21st at 2:00 PM EST",
        "halftime": false,
        "firstHalfEnded": false
      },
      "homeTeam": {
        "id": "189",
        "name": "New England Revolution",
        "abbreviation": "NE",
        "logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXQAOWRMQEENcUx1GVQJPH0pXAQ",
        "color": "022166",
        "alternateColor": "ce0e2d",
        "winner": false,
        "score": 0
      },
      "awayTeam": {
        "id": "10739",
        "name": "Philadelphia Union",
        "abbreviation": "PHI",
        "logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXQAOWRMQEENcUx1GVQpBAgMXFl0E",
        "color": "051f31",
        "alternateColor": "e0d0a6",
        "winner": false,
        "score": 0
      },
      "competition": {
        "attendance": 0,
        "neutralSite": false,
        "conferenceCompetition": false,
        "divisionCompetition": false,
        "playByPlayAvailable": true,
        "highlightsAvailable": false
      },
      "venue": {
        "id": "10660",
        "name": "Gillette Stadium",
        "city": "Foxborough, Massachusetts",
        "indoor": false,
        "grass": false
      },
      "notes": [],
      "season": {
        "year": 2026,
        "displayName": "2026 MLS",
        "type": {
          "id": "5",
          "name": "Eastern Conference Playoffs - Round One",
          "abbreviation": "Eastern Conference - Round One"
        },
        "week": {}
      },
      "broadcasts": [
        {
          "network": "Apple TV",
          "type": "STREAMING"
        }
      ],
      "officials": []
    }
  ],
  "meta": {
    "rateLimit": {
      "limit": 125,
      "remaining": 124,
      "reset": 1796083200000
    }
  }
}

MLS endpoints

Checked against live data on 2026-10-04. Paths are relative to /api/v1/sports/soccer/leagues/usa.1.

EndpointPathMLSNotes
Live scores/events/liveAvailable
Events (scoreboard)/eventsAvailable
Event detail/events/{eventId}Available
Play-by-play/events/{eventId}/playsAvailable
Box score/events/{eventId}/boxscoreLimitedTeam totals and period scores only; player stats are not returned.
Odds/events/{eventId}/oddsAvailable
Win probability/events/{eventId}/winprobabilityNot available
Teams/teamsAvailable
Rosters/teams/{teamId}/rosterAvailable
Athletes/athletes/searchAvailable
Injuries/injuriesNot available
News/newsAvailable
Schedule / weeks/seasons/{season}/scheduleAvailable
NCAA tournament/seasons/{season}/tournamentNot available
Rankings/rankingsNot available
Webhooks/webhooksAvailable
WebSocket/websocket/authAvailable
  • Schedules are by date, not week: use /events for the current scoreboard and /seasons/{season}/schedule for a season. Week parameters return SCHEDULE_WEEKS_NOT_SUPPORTED.
  • Soccer play-by-play is a stream of match events (passes, shots, fouls, cards); box scores carry team totals and period scores without player rows.

Every MLS game in the events, live and schedule endpoints uses the same Event object as other leagues: Event object field reference.

MLS API in Python, JavaScript and curl

curl

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/usa.1/events?limit=5"

JavaScript (fetch)

const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/usa.1/events?limit=5", {
  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/soccer/leagues/usa.1/events?limit=5",
    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_events with sport "soccer" and league "usa.1" and list the games it returns with start times, status and scores for MLS.

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

Real-time MLS push: WebSocket and webhooks

Instead of polling, paid plans can receive every MLS game start, score change and final as it is detected (typically 20-30 seconds behind live play): a MLS WebSocket feed for live dashboards and apps, or MLS webhooks that POST each event to your server. On the Free plan you can watch the stream and send yourself a sample webhook from the dashboard.

Shipping a product with MLS 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.

MLS API pricing and rate limits

The MLS API is included in every plan, Free included: one key covers all leagues. Free starts with 1,000 calls in your first 30 days (no card); paid plans start at $29/month with a 7-day free trial.

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.

29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions.

FAQ

Is there a free MLS API?
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. The same key works for all 29 leagues.
How fresh is the MLS 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. It is not intended for in-play betting that needs sub-second data.
Which MLS endpoints are available?
Available: live scores, events (scoreboard), event detail, play-by-play, odds, teams, rosters, athletes, news, schedule / weeks. Not available or not verified: box score (limited), win probability (not available), injuries (not available), ncaa tournament (not available), rankings (not available).
Does the MLS API include betting odds?
Yes. Upcoming MLS games returned a spread, moneyline and total when we checked, from a single source book, with line history. It is not a multi-book comparison feed and not suited to sub-second in-play betting.
Does it include MLS injuries?
No. The injuries endpoint returned no records for MLS when we checked, so treat injuries as not available for this league.
Can I get MLS score updates pushed instead of polling?
Yes. 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. Both can be filtered to usa.1.