# LaLiga Tracker ⚽ - Standings, Fixtures & Team Stats (`tikitakaclaw/laliga-tracker`) Actor Real-time Spanish LaLiga data: standings, fixtures (past + upcoming), team rosters, scores, and detailed stats. Uses ESPN public API (no auth). Perfect for sports media, fantasy apps, betting analytics, dashboards. - **URL**: https://apify.com/tikitakaclaw/laliga-tracker.md - **Developed by:** [TikitakaClaw Pikipiki](https://apify.com/tikitakaclaw) (community) - **Categories:** Other, Automation, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 match or standings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## LaLiga Tracker ⚽ **Real-time Spanish LaLiga data** — standings, fixtures, and team rosters. Powered by ESPN's public API (no authentication, no rate limits). Perfect for sports media, fantasy apps, betting analytics, dashboards, and chatbots. --- ### What you get For each run, you choose which data to fetch: #### 📊 Standings - Current league table (rank, team, played, wins, draws, losses, goals, points) - 20 LaLiga teams (Primera División) - Includes qualification zone notes (Champions League, Europa League, relegation) - Team logos + clubhouse URLs #### 📅 Fixtures (Past + Upcoming) - Matchday matchups - Home/Away teams with logos and scores - Match status (scheduled, in-progress, completed) - Venue information - Matchweek number #### ⚽ Teams - All 20 LaLiga clubs - Names, abbreviations, locations - Team logos (high-res URLs) - Active/inactive status --- ### Input ```json { "dataTypes": ["standings", "fixtures", "teams"], "season": 2026, "fixturesRange": 14 } ```` #### Field reference | Field | Type | Default | Description | |---|---|---|---| | `dataTypes` | array | `["standings", "fixtures", "teams"]` | Which datasets to fetch. Multi-select. | | `season` | integer | `2026` | Season start year (e.g. 2026 = 2026-27) | | `fixturesRange` | integer | `14` | Days of fixtures to fetch (split between past and future) | *** ### Output examples #### Standing ```json { "type": "standing", "season": "2026-27 LALIGA", "rank": 1, "note": "Champions League", "teamId": "96", "teamName": "Alavés", "teamShortName": "Alavés", "abbreviation": "ALA", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/96.png", "clubhouseUrl": "https://www.espn.com/soccer/club/_/id/96/alaves", "stats": { "gamesPlayed": 38, "wins": 25, "draws": 8, "losses": 5, "goalsFor": 78, "goalsAgainst": 32, "goalDifferential": 46, "points": 83 } } ``` #### Fixture ```json { "type": "fixture", "season": 2026, "matchId": "401564123", "name": "Getafe at Alavés", "shortName": "GET @ ALA", "date": "2026-08-16T18:00Z", "status": "Scheduled", "statusState": "pre", "isCompleted": false, "matchweek": 1, "venue": "Estadio de Mendizorroza", "homeTeam": { "id": "96", "name": "Alavés", "abbreviation": "ALA", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/96.png", "score": 0, "winner": null }, "awayTeam": { "id": "98", "name": "Getafe", "abbreviation": "GET", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/98.png", "score": 0, "winner": null } } ``` #### Team ```json { "type": "team", "league": "LaLiga", "teamId": "96", "name": "Alavés", "shortName": "Alavés", "abbreviation": "ALA", "location": "Vitoria-Gasteiz", "color": "#0a4dad", "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/96.png", "clubhouseUrl": "https://www.espn.com/soccer/club/_/id/96/alaves", "isActive": true } ``` *** ### Pricing **Pay per event:** | Event | Cost | |---|---| | Standing | $0.001 | | Fixture | $0.0005 | | Team | $0.0005 | > ℹ️ Apify's platform usage (CU) is **passed through** — no markup. You pay the per-event fee on top of CU. **Example:** All 3 data types once = 20 + 10 + 20 = ~50 events × ~$0.0007 = **$0.04 per run**. Schedule daily = **$1.20/month**. *** ### Use cases 1. **📰 Sports media/blogs** — auto-publish daily LaLiga summaries 2. **🤖 Telegram/Discord bots** — live scores and standings 3. **📊 Fantasy football apps** — feed player data, fixtures, standings 4. **💰 Betting analytics** — backtest prediction models against historical standings 5. **📈 Dashboards** — real-time LaLiga dashboard for websites 6. **🤖 LLM training data** — historical + current LaLiga data for sports analysis models 7. **📱 Mobile apps** — push notifications for team updates *** ### Technical notes - **API:** ESPN public soccer API (`site.api.espn.com`) - **No authentication required** — public endpoints - **No rate limiting** (reasonable usage) - **Build time:** ~30s - **Memory:** 128 MB typical - **Runtime:** 1-3 seconds per run (depends on data types) *** ### Season info - **Current season:** 2026-27 (starts mid-August 2026) - **Matchdays:** 38 per season (20 teams, 2 matches each) - **Schedule:** August → May - **Derby matches:** El Clásico (Real Madrid vs Barcelona), Madrid Derby, Seville Derby, Basque Derby, etc. *** ### Changelog - **0.1.0** (2026-07-05) — Initial release. Standings, fixtures, teams. *** ### Support - 🐛 Report issues: Apify Console → this Actor → Issues tab - 💬 Questions: [Apify Discord](https://discord.com/invite/jyEM2PRvMU) - 📧 Author: [@tikitakaclaw](https://apify.com/tikitakaclaw) on Apify *** ### License MIT License. Data from ESPN public API. Not affiliated with LaLiga or ESPN. # Actor input Schema ## `dataTypes` (type: `string`): Which datasets to retrieve. Use a comma-separated list of: standings, fixtures, teams. ## `season` (type: `integer`): Season start year (e.g. 2026 = 2026-27 season). ## `fixturesRange` (type: `integer`): How many days of fixtures to fetch (past + future from today). ## Actor input object example ```json { "dataTypes": "standings,fixtures,teams", "season": 2026, "fixturesRange": 14 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("tikitakaclaw/laliga-tracker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("tikitakaclaw/laliga-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call tikitakaclaw/laliga-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=tikitakaclaw/laliga-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "LaLiga Tracker ⚽ - Standings, Fixtures & Team Stats", "description": "Real-time Spanish LaLiga data: standings, fixtures (past + upcoming), team rosters, scores, and detailed stats. Uses ESPN public API (no auth). Perfect for sports media, fantasy apps, betting analytics, dashboards.", "version": "0.2", "x-build-id": "XZZ3fJfOw0qOg5BHk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tikitakaclaw~laliga-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tikitakaclaw-laliga-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/tikitakaclaw~laliga-tracker/runs": { "post": { "operationId": "runs-sync-tikitakaclaw-laliga-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/tikitakaclaw~laliga-tracker/run-sync": { "post": { "operationId": "run-sync-tikitakaclaw-laliga-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "dataTypes" ], "properties": { "dataTypes": { "title": "Data to fetch", "type": "string", "description": "Which datasets to retrieve. Use a comma-separated list of: standings, fixtures, teams.", "default": "standings,fixtures,teams" }, "season": { "title": "Season year", "minimum": 2020, "maximum": 2030, "type": "integer", "description": "Season start year (e.g. 2026 = 2026-27 season).", "default": 2026 }, "fixturesRange": { "title": "Fixtures time range", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many days of fixtures to fetch (past + future from today).", "default": 14 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```