# Changelog of Football API Scraper — Fixtures, Standings & Match Data (`sian.agency/football-api-scraper`) Actor

- **URL**: https://apify.com/sian.agency/football-api-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/football-api-scraper.md

## Changelog

All notable changes to Football API Scraper will be documented in this file.

### \[2026-07-31]

#### 🎉 Football API Scraper — Launch!

- **18 Football Operations, One Actor** — pull football fixtures, results, league standings, season team statistics, squads, transfers, club and player profiles, match lineups, incidents, match statistics, odds, best players and live matches from a single `operation` switch.
- **Home and Away League Tables** — the football standings split that form and prediction models actually need, alongside the full table.
- **32 Season Metrics Per Club** — expected goals, expected assists, ball possession, big chances, clean sheets, goals prevented, sprints, duels and kilometres covered, one clean row per team.
- **Match Lineups With Per-Player Ratings** — starting XI, bench, formation, unavailable players and ~28 per-player match metrics including rating, expected assists, touches and minutes played.
- **Squads, Market Values and Transfers** — full football squad data with contract-until dates and market values, plus arrivals and departures with fees and fee descriptions.
- **Match Detail Down to the Minute** — goals with assists, yellow and red cards with reasons, substitutions, added time, and 46 match statistics split by full match, first half and second half.
- **Pre-Match Odds Across 18 Markets** — 1X2, double chance, both teams to score, Asian handicap, match goals, cards and corners for any match ID.
- **Live Football Matches** — every match currently in play, in the same row shape as fixtures, ready for live score widgets and goal alerts.
- **Agent-Ready Design** — a single flat operation enum, chained IDs and one consistent row contract so an AI assistant can pick the right call without reading documentation.

#### 💎 User Benefits

- Replaces four or five separate football scrapers with one actor and one dataset schema.
- Row-value pricing: a 30-match fixture page and a single club profile are not billed the same, because they are not worth the same.
- Charged only for successful rows — input is validated before anything is charged, and error rows are never billed.
- A `maxResults` cap lets you fix the cost of a run before you start it.
- No football data account or API key of your own to manage.

#### 🎯 Use Cases

- Fantasy football platform operators auto-pricing players and auto-scoring gameweeks from squads, market values and per-player match ratings.
- Betting model builders engineering home-advantage and expected-goals features from home-only and away-only league tables plus season team statistics.
- Product teams shipping live score widgets and goal alerts from live matches and minute-by-minute match incidents.
- Club analysts and scouts spotting contract-expiry opportunities from squad data with contract end dates and transfer history.
- Sports media teams auto-generating match previews, lineup graphics, league table updates and post-match reports for every fixture in a round.
- Data scientists assembling reproducible multi-season football datasets without hand-cleaning scraped HTML.