Italy Football Results & Tables

What does Italy Football Results & Tables do?

Italy Football Results & Tables returns structured Italian football match results and league tables for selected domestic competitions. It focuses on supported league competitions only: Serie A, Serie B.

The actor is useful as a lightweight Italian football API alternative when you need clean rows for dashboards, spreadsheets, scheduled updates, reporting workflows, or downstream data pipelines.

Why use Italy Football Results & Tables?

Use this actor when you need Italian football data in a consistent dataset instead of manually checking separate competition pages. You can select several competitions in one run, limit match output to a specific round or matchday, and return matches and calculated standings as two separate output tables.

Main capabilities:

• Retrieve fixtures, dates, teams, scores, status, and winners.
• Calculate standings from completed full-time results.
• Compare supported Italian competitions in one normalized format.
• Schedule matchday runs on Apify and export data through the API.
• Append results into an existing Apify dataset with datasetId.
• Add your own workflow identifier with runId.

What data can it extract?

Field	Type	Description
leagueName	string	Italy competition name
competitionType	string	league
competitionGender	string	men
country	string	Italy
season	number	Season start year
round	number	Matchday when available
matchDate	string	Match date in ISO 8601 format
homeTeam, awayTeam	string	Teams for match rows
homeScore, awayScore	number	Full-time score when available
winner	string	home, away, draw, or empty
position, teamName, points	number/string	Standing row fields
played, won, drawn, lost	number	League record
goalsFor, goalsAgainst, goalDifference	number	League-table goal fields

Supported Italy competitions

The dropdown currently supports:

• Serie A
• Serie B

This actor does not currently include cups, European competitions, youth leagues, or women's leagues because the free no-key dataset coverage is not stable enough for this launch scope.

Use cases

• Build Italian football dashboards and matchday trackers.
• Keep spreadsheets of Italian league results.
• Feed editorial tools with structured score and table data.
• Compare selected Italian competitions in one normalized output.
• Schedule daily or matchday updates through Apify.
• Combine this dataset with club, attendance, media, or market workflows where legally permitted.

How to use it

1. Open the actor input tab.
2. Choose one or more Italy competitions from the Competitions dropdown.
3. Set the season start year, for example 2025 for 2025/2026.
4. Optionally set Round to retrieve only one matchday.
5. Keep Include Matches enabled for fixtures and scores.
6. Keep Include Standings enabled when you want calculated league tables.
7. Run the actor and download the Matches and Standings tables as JSON, CSV, Excel, XML, or HTML.

Input

See the input tab for full configuration options.

Example input:

{
  "leagues": ["serie-a","serie-b"],
  "season": 2025,
  "round": 1,
  "includeMatches": true,
  "includeStandings": true,
  "maxMatches": 20
}

For scheduled matchday updates, set round and keep maxMatches low. For full-season match exports, leave round blank and raise maxMatches. Standings rows are calculated from all completed full-time matches available for the selected season, not from the selected round only.

Output

The actor creates two output tables: Matches and Standings. You can download each dataset in various formats such as JSON, HTML, CSV, or Excel.

Example output:

[
  {
    "leagueName": "Italian Serie A",
    "competitionType": "league",
    "competitionGender": "men",
    "country": "Italy",
    "season": 2025,
    "round": 1,
    "matchDate": "2025-08-23T00:00:00.000Z",
    "status": "finished",
    "homeTeam": "Genoa CFC",
    "awayTeam": "US Lecce",
    "homeScore": 0,
    "awayScore": 0,
    "winner": "draw"
  },
  {
    "leagueName": "Italian Serie A",
    "competitionType": "league",
    "competitionGender": "men",
    "country": "Italy",
    "season": 2025,
    "position": 1,
    "teamName": "FC Internazionale Milano",
    "played": 34,
    "won": 22,
    "drawn": 7,
    "lost": 5,
    "goalsFor": 64,
    "goalsAgainst": 26,
    "goalDifference": 38,
    "points": 73
  }
]

API usage example

curl "https://api.apify.com/v2/acts/trovevault~italy-football-results-tables/runs?waitForFinish=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "leagues": ["serie-a","serie-b"],
    "season": 2025,
    "round": 1,
    "includeMatches": true,
    "includeStandings": true,
    "maxMatches": 20
  }'

Limitations

This actor covers supported Italy domestic league competitions only. It does not include Champions League, Europa League, national-team fixtures, cups, player-level scorer feeds, or unsupported lower divisions in this version.

Standings are calculated from completed full-time match results available in the public dataset. If some recent matches have not been updated yet, the calculated table can lag until the source dataset is updated.

FAQ

Does this actor include Champions League?

No. The scope is supported Italy domestic leagues only.

Can I select multiple leagues?

Yes. The Competitions field is a multi-select dropdown.

Does the actor include cups?

No. This first version is league-only so that standings remain meaningful.

Which season format should I use?

Use the season start year. For example, 2025 means the 2025/2026 season.

Can I get only one round?

Yes. Set Round to a matchday number. Standings still use all completed season matches.

Does the actor include scorers?

No. This actor is standardized around match results and standings only.

Is the output suitable for spreadsheets?

Yes. Matches and standings are separate flat tables that export cleanly to CSV or Excel.

Can I append results to an existing dataset?

Yes. Fill datasetId to append rows to another Apify dataset in addition to the default run datasets. When both matches and standings are appended to this external dataset, the actor adds entityType so downstream workflows can distinguish match and standing rows.

Troubleshooting

If a run returns fewer rows than expected, check the selected season and round first. The free JSON dataset coverage for this actor starts at 2013/2014. Older inputs such as 2000 are outside the supported source coverage, and the current season can be incomplete until public data updates land.

If standings do not match the selected round, that is expected: tables are calculated from the full available season, not one historical matchday.

For bugs, missing competitions, or output issues, use the Issues tab on the actor page.

Related actors

For a similar country-specific actor, see German Football Results & Tables.

Changelog

0.1

Initial version with supported Italy football matches and calculated league tables.