Marca APImarca.com ↗
Access LALIGA and Segunda División standings, match results, and top scorer data from marca.com via 3 structured JSON endpoints.
What is the Marca API?
The Marca.com API exposes 3 endpoints covering Spanish football data from marca.com, including current league standings, match results by date, and the Pichichi top-scorer rankings. The get_standings endpoint returns full classification tables with home/away splits, while get_matches delivers scheduled and live fixture data with scores, venue, and TV broadcast details. Coverage spans LALIGA EA Sports and Segunda División.
curl -X GET 'https://api.parse.bot/scraper/055f8d3f-ce8d-4a59-979b-dc8faf48cb4a/get_standings?tournament=primera' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace marca-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.marca_sports_api import Marca, Tournament_, Standing, Match, Scorer
marca = Marca()
# Get La Liga standings
laliga = marca.tournament(Tournament_.PRIMERA)
for team in laliga.standings():
print(team.name, team.position, team.points, team.goal_difference)
# Get matches for a specific date
for match in laliga.matches(date="2026-05-24"):
print(match.home_team_name, match.home_score, match.away_score, match.away_team_name, match.venue)
# Get top scorers (Pichichi)
for scorer in laliga.top_scorers():
print(scorer.rank, scorer.name, scorer.team, scorer.total_goals, scorer.penalty_goals)
Get league standings/classification for a tournament. Returns the current season classification with full team rankings including points, wins, draws, losses, and goal difference. Each team entry includes position, home/away splits, and team logo URL.
| Param | Type | Description |
|---|---|---|
| tournament | string | Tournament identifier. |
{
"type": "object",
"fields": {
"season": "string - season identifier like 2025-26",
"standings": "array of team standing objects with id, name, full_name, position, points, played, won, drawn, lost, goals_for, goals_against, goal_difference, image_url",
"tournament_name": "string - name of the tournament"
},
"sample": {
"data": {
"season": "2025-26",
"standings": [
{
"id": "178",
"won": "31",
"lost": "6",
"name": "Barcelona",
"drawn": "1",
"played": "38",
"points": "94",
"position": "1",
"full_name": "Barcelona",
"goals_for": "95",
"image_url": "https://e01-marca.uecdn.es/assets/datos-deportivos/escudos/opta/png/35x35/178.png",
"goals_against": "36",
"goal_difference": "59"
}
],
"tournament_name": "LALIGA EA Sports"
},
"status": "success"
}
}About the Marca API
Standings and Classification
The get_standings endpoint accepts an optional tournament parameter to select LALIGA EA Sports or Segunda División. The response includes a standings array where each object carries position, points, played, won, drawn, lost, goals_for, goals_against, and goal difference alongside home/away performance splits. The season field identifies the current season (e.g., 2025-26) and tournament_name confirms which competition the table belongs to.
Match Fixtures and Results
get_matches returns fixtures for a given date (ISO format YYYY-MM-DD, defaulting to today UTC) filtered by tournament. Each match object includes team IDs and names for both sides, home_score and away_score, venue, start_date, match status, and TV channel information. If no matches are scheduled for the requested date, the endpoint returns an empty matches array rather than an error. Dates within the active season window (roughly August through May) are most likely to return populated results.
Top Scorers (Pichichi)
The get_top_scorers endpoint returns the current season's Pichichi ranking for the selected tournament. Each scorer object includes rank, name, team, and a breakdown of total_goals into foot_goals, header_goals, penalty_goals, and free_kick_goals. This granularity makes it straightforward to filter or sort players by goal type rather than total alone.
The Marca API is a managed, monitored endpoint for marca.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when marca.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official marca.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a live LALIGA standings table with home/away records in a football app.
- Send push notifications when a specific team's match status changes using
get_matches. - Build a Pichichi tracker that breaks down player goals by foot, header, and penalty.
- Aggregate fixture data across multiple dates to generate a weekly match calendar.
- Compare goal-difference and points across all Segunda División clubs for promotion analysis.
- Show broadcast channel information so users know where to watch upcoming matches.
- Populate a daily football dashboard with standings, fixtures, and scorer stats from a single API.
| 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 | 100 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 marca.com have an official developer API?+
What does `get_matches` return when no games are scheduled?+
matches array. The endpoint does not raise an error for valid dates that have no fixtures. Check the status field on individual match objects to distinguish scheduled, in-progress, and finished games.Does the API cover competitions beyond LALIGA and Segunda División?+
tournament parameter on all three endpoints covers LALIGA EA Sports and Segunda División. You can fork this API on Parse and revise it to add endpoints targeting other competitions.Is historical match or standings data available for past seasons?+
What goal-type detail does `get_top_scorers` include?+
total_goals into four subtypes: foot_goals, header_goals, penalty_goals, and free_kick_goals. The rank, name, and team fields are also included for every player in the current season's ranking.