mlssoccer.com APIwww.mlssoccer.com ↗
Fetch MLS match schedules, live scores, and detailed game info via the mlssoccer.com API. Covers Regular Season, MLS NEXT Pro, US Open Cup, and CONCACAF Champions Cup.
curl -X GET 'https://api.parse.bot/scraper/fac056a7-b2b6-4a9f-8c3a-aeea37e99963/get_matches?date_to=2026-05-14&date_from=2026-05-10&competition=mls' \ -H 'X-API-Key: $PARSE_API_KEY'
Get MLS matches for a date range. Returns live scores, upcoming matches with start times, and completed results. Includes match status (scheduled, live, finalWhistle), team names, scores, kickoff times, and venue info. Results are sorted by kickoff time.
| Param | Type | Description |
|---|---|---|
| date_to | string | End date in YYYY-MM-DD format. Defaults to 6 days from current UTC date. |
| date_from | string | Start date in YYYY-MM-DD format. Defaults to yesterday relative to current UTC date. |
| competition | string | Filter by competition. Accepted values: 'mls', 'mls-regular', 'mls-next-pro', 'next-pro', 'us-open-cup', 'open-cup', 'concacaf', 'champions-cup'. Returns all competitions if omitted. |
{
"type": "object",
"fields": {
"date_to": "string - end date used for the query",
"matches": "array of match objects with: match_id, match_status, competition, competition_label, match_type, home_team {name, short_name, abbreviation, goals}, away_team {name, short_name, abbreviation, goals}, score, kickoff_time (ISO 8601 UTC), stadium, stadium_city, season, match_day",
"date_from": "string - start date used for the query",
"total_matches": "integer - number of matches returned"
},
"sample": {
"data": {
"date_to": "2026-05-14",
"matches": [
{
"score": "3:1",
"season": 2026,
"stadium": "Toyota Stadium",
"match_id": "MLS-MAT-0009FO",
"away_team": {
"name": "Real Salt Lake",
"goals": 1,
"short_name": "Salt Lake",
"abbreviation": "RSL"
},
"home_team": {
"name": "FC Dallas",
"goals": 3,
"short_name": "Dallas",
"abbreviation": "DAL"
},
"match_day": 12,
"match_type": "MATCHWEEK 12",
"competition": "Major League Soccer - Regular Season",
"kickoff_time": "2026-05-10T00:30:00Z",
"match_status": "finalWhistle",
"stadium_city": "Frisco, TX",
"competition_label": "MLS Regular Season 2026"
}
],
"date_from": "2026-05-10",
"total_matches": 23
},
"status": "success"
}
}About the mlssoccer.com API
The mlssoccer.com API provides access to MLS match data across 2 endpoints, returning live scores, upcoming fixtures, and completed results for all major competitions. The get_matches endpoint retrieves matches within a date range filtered by competition, while get_match_details returns per-match information including team logos, broadcaster details, venue, and streaming URLs for a specific match ID.
Match Schedules and Live Scores
The get_matches endpoint accepts optional date_from and date_to parameters in YYYY-MM-DD format, defaulting to yesterday through six days ahead. Each match object includes match_id, match_status (one of scheduled, live, or finalWhistle), competition, competition_label, match_type, home and away team names with short names and abbreviations, scores, and kickoff times. Results are sorted by kickoff time. The optional competition filter accepts values such as mls-regular, mls-next-pro, us-open-cup, and next-pro, letting you narrow the result set to a specific league or cup.
Detailed Match Information
The get_match_details endpoint takes a single required match_id (e.g. MLS-MAT-0009FO, obtained from get_matches) and returns a richer object. Fields include home_team and away_team objects with name, short_name, abbreviation, id, slug, and logo_url; a venue object with name and city; match_date in ISO 8601 UTC; match_day; round_name for cup or playoff stages; and a competition object with name, short_name, and slug. The endpoint also surfaces broadcaster and streaming URL data not available from the schedule endpoint. If the provided match_id is not found, the endpoint returns a stale_input status rather than an error.
Competition Coverage
The API covers four competitions accessible via the competition filter: MLS Regular Season (mls or mls-regular), MLS NEXT Pro (mls-next-pro or next-pro), US Open Cup (us-open-cup), and CONCACAF Champions Cup. This maps directly to the competitions MLS publishes through mlssoccer.com. The competition_label field on each match object carries the human-readable competition name for display purposes.
- Display a live MLS scoreboard widget using
match_statusand current scores fromget_matches - Build a fixture calendar for a specific club by filtering
get_matchesresults by team name over a date range - Show broadcaster and streaming links for an upcoming match using
get_match_details - Track MLS NEXT Pro results by filtering
get_matcheswith themls-next-procompetition value - Render team crests in a match preview using
logo_urlfromget_match_detailshome and away team objects - Surface venue and city information for travel or event planning using the
venueobject inget_match_details - Identify cup round and stage context (e.g. semifinals) via the
round_namefield inget_match_details
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MLS Soccer have an official developer API?+
What does `match_status` return and what values should I expect?+
match_status field in get_matches returns one of three string values: scheduled for fixtures that have not yet kicked off, live for matches currently in progress, and finalWhistle for completed matches. This field is the primary signal for distinguishing upcoming, in-progress, and finished games.Does the API return player stats, lineups, or goal scorers?+
How far ahead or behind can I query with `get_matches`?+
date_from and date_to parameters accept any YYYY-MM-DD value. The defaults cover yesterday through six days ahead, but you can specify arbitrary past or future dates to query historical results or fixtures further out, as long as the data exists for that range on mlssoccer.com.