# MARCA Sports Scores API

> MARCA live sports scores: football, basketball, ice hockey and tennis results by date

- Vendor: `marcasportsscoresapi` · version 1.0 · category Sports · tags marca api, live scores api, football scores api, soccer results api, nba scores api, sports results api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/marcasportsscoresapi
- This document: https://apiclay.com/docs/marcasportsscoresapi.md
- OpenAPI 3.1: https://apiclay.com/api/marcasportsscoresapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `marcasportsscoresapi`
- Updated: 2026-11-18

## About

## MARCA Sports Scores API

The scores feed behind MARCA.com, the Spanish sports daily (Unidad Editorial): every match MARCA tracks on a given day across football (LaLiga, Premier League, Champions League, Nations League, Latin American leagues and more), basketball (NBA, EuroLeague, ACB), ice hockey (NHL), tennis and handball, with tournament, season, match day, home and away teams with crests, kick-off time, status, score and winner; and one event by id with the same detail.

Data comes from **marca.com** (https://www.marca.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/events?date=2026-11-13`, then `/event?id=` for one match.

### Routes

#### GET `/events` - Events by date
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| date | query | string | yes | Day `YYYY-MM-DD`. |

Returns: `status` and `data` array of events: `id`, `startDate`, `sport` (`name`, `alternateNames.enEN`), `tournament` (`id`, `name`), `season`, `matchDay`, `sportEvent` (`competitors.homeTeam` / `awayTeam` with `fullName`, `abbName`, `country`, crest `imageUrl`; `status`), `score` (`homeTeam.totalScore`, `awayTeam.totalScore`, `winner`, `period`). About 300 KB for a busy day.

#### GET `/event` - Event
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Event `id` from `/events`. |

Returns: `data` with the same fields as one `/events` item.

### Caveats

- Names are in Spanish with English in `alternateNames.enEN`. Scores are MARCA's live data and may lag; team crests come from MARCA's image CDN.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by marca.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /events — Events by date
- Gateway: `GET https://api.apiclay.com/v1/api/marcasportsscoresapi/events`
- Public query params: `date` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /event — Event
- Gateway: `GET https://api.apiclay.com/v1/api/marcasportsscoresapi/event`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/marcasportsscoresapi/events?date=<date>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
