Football Fixtures Scraper

Get football fixtures and results for any team using the reliable Football-Data.org API - no web scraping, no blocking, just clean data.

Fetches football fixtures and results using the Football-Data.org API for any team and competition.

Features

• 🎯 Team-specific data: Get both upcoming fixtures and past results for any football team
• 📅 Date range filtering: Specify start and end dates to fetch historical or future matches
• 🏆 Competition filtering: Filter by specific competitions (Premier League, Champions League, etc.)
• ⚡ Fast API-based: Uses reliable Football-Data.org API (no web scraping)
• 📊 Structured output: Clean JSON data with match details, venues, scores, and status
• 🆓 Free tier available: Get started with a free API key

💡 Use Cases

• Sports Analytics: Track team performance with historical results and upcoming fixtures
• Betting Research: Analyze past results and fixture schedules for predictions
• Content Creation: Auto-update sports websites with live scores and fixture data
• Notifications: Build alerts for upcoming matches of your favorite teams
• Data Integration: Feed match data (past and future) into BI tools or dashboards
• Fantasy Football: Plan your transfers based on upcoming fixtures and recent form
• Historical Analysis: Study team performance patterns across seasons

Prerequisites

You'll need a free API key from Football-Data.org. Registration takes 2 minutes.

Free Tier Includes:

• 10 requests per minute
• Access to major European leagues (Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, etc.)
• Current season data

How to Use

1. Get your free API key from https://www.football-data.org/client/register
2. Click "Try for free" or "Start" button
3. Enter your inputs:

{
  "apiKey": "your_api_key_here",
  "teamName": "Chelsea FC",
  "competition": "PL",
  "dateTo": "2026-05-31",
  "maxItems": 50
}

4. Run the Actor and download results as JSON, CSV, or Excel

Input Parameters

Parameter	Type	Required	Default	Description
apiKey	string	✓	-	Your Football-Data.org API key (stored securely)
teamName	string	✓	"Chelsea FC"	Full team name (e.g., "Chelsea FC", "Manchester United FC")
competition	string		-	Competition code (PL, CL, etc.). Leave empty for all
dateFrom	string		Today	Start date for matches (YYYY-MM-DD) - use past dates for results
dateTo	string		"2026-05-31"	End date for matches (YYYY-MM-DD)
maxItems	integer		50	Maximum number of matches to return

Competition Codes

Common competition codes:

• PL - Premier League (England)
• PD - La Liga (Spain)
• BL1 - Bundesliga (Germany)
• SA - Serie A (Italy)
• FL1 - Ligue 1 (France)
• CL - UEFA Champions League
• EL - UEFA Europa League
• WC - FIFA World Cup

Output

Each match contains:

Upcoming Fixture:

{
  "matchDate": "2026-01-25T15:00:00Z",
  "homeTeam": "Chelsea FC",
  "awayTeam": "Manchester City FC",
  "competition": "Premier League",
  "venue": "Stamford Bridge",
  "matchUrl": "https://www.football-data.org/match/12345",
  "status": "TIMED",
  "matchday": 23,
  "score": {
    "winner": null,
    "fullTime": {"home": null, "away": null}
  }
}

Finished Match:

{
  "matchDate": "2025-12-15T15:00:00Z",
  "homeTeam": "Chelsea FC",
  "awayTeam": "Arsenal FC",
  "competition": "Premier League",
  "venue": "Stamford Bridge",
  "matchUrl": "https://www.football-data.org/match/12346",
  "status": "FINISHED",
  "matchday": 17,
  "score": {
    "winner": "HOME_TEAM",
    "fullTime": {"home": 2, "away": 1},
    "halfTime": {"home": 1, "away": 0}
  }
}

📈 Example Results

Example 1: Upcoming Chelsea Premier League Fixtures

{
  "teamName": "Chelsea FC",
  "competition": "PL",
  "dateTo": "2026-03-31"
}

Result: 10 upcoming Premier League fixtures for Chelsea

Example 2: Chelsea Past Results (Last 30 Days)

{
  "teamName": "Chelsea FC",
  "competition": "PL",
  "dateFrom": "2025-12-20",
  "dateTo": "2026-01-20"
}

Result: Recent Chelsea Premier League matches with scores

Example 3: All Chelsea Matches (Past and Future)

{
  "teamName": "Chelsea FC",
  "dateFrom": "2025-12-01",
  "dateTo": "2026-05-31"
}

Result: All Chelsea matches across all competitions (finished + upcoming)

Example 4: Champions League Fixtures

{
  "teamName": "Real Madrid CF",
  "competition": "CL",
  "maxItems": 20
}

Result: Upcoming Champions League matches for Real Madrid

💰 Pricing

This Actor uses pay-per-event pricing. You pay for what you get - simple and transparent.

Pricing Structure

Startup fee: $0.01 per run (all tiers)

Per match pricing (varies by Apify subscription tier):

Apify Plan	Tier	Price per Match	Price per 1,000 Matches
Free	BASIC	$0.002	$2.00
Starter ($49/mo)	BRONZE	$0.00175	$1.75
Team ($499/mo)	SILVER	$0.0015	$1.50
Business ($999/mo)	GOLD	$0.00125	$1.25

Higher tier subscribers save up to 37.5% on per-match costs

Example Costs (BASIC Tier)

Matches Returned	Startup	Match Charges	Total Cost
50 matches	$0.01	$0.10	$0.11
100 matches	$0.01	$0.20	$0.21
500 matches	$0.01	$1.00	$1.01
1,000 matches	$0.01	$2.00	$2.01

Enterprise Savings Example

Business (GOLD) tier fetching 1,000 matches:

• Startup: $0.01
• 1,000 matches × $0.00125 = $1.25
• Total: $1.26 (vs $2.01 on BASIC - save $0.75 per run)

What You're Paying For

• ✅ Reliable Football-Data.org API access
• ✅ Clean, structured JSON output
• ✅ Both upcoming fixtures AND past results
• ✅ No rate limit worries (we handle API management)
• ✅ Fast, efficient data delivery

Platform Costs

In addition to the Actor pricing, Apify charges for compute resources:

• Compute cost: ~$0.0003 per run (minimal, API-based actor)
• First 5 seconds: FREE (waived with startup fee)
• Most runs complete in 10-15 seconds

Total typical cost for 100 matches: ~$0.21

External API Requirements

You'll need your own Football-Data.org API key:

• Free tier: 10 requests/minute - perfect for most use cases
• Paid plans: From €10/month for higher limits and commercial use
• Get your key: Football-Data.org Registration
• See pricing details

🔗 Integration

Use with Apify Integrations:

• Export to Google Sheets for analysis
• Send to Slack/Discord webhooks for notifications
• Save to Dropbox/Google Drive for archival
• Trigger with Apify Scheduler for daily fixture updates

API Access:

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('YOUR_USERNAME/flashscore-fixtures-scraper').call({
  apiKey: 'your_football_data_key',
  teamName: 'Chelsea FC',
  competition: 'PL'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Found ${items.length} fixtures`);

Scheduled Runs: Set up daily/weekly runs to automatically fetch updated fixture lists and monitor for schedule changes.

API Information

About Football-Data.org

Football-Data.org provides comprehensive football data including:

• Fixtures and results
• Team information
• Player statistics
• Competition standings
• Live scores

Free Tier Limitations

• Rate limit: 10 requests per minute
• Coverage: Major European leagues and international competitions
• Historical data: Limited to current season
• No commercial use: Free tier is for personal/educational use only

Need More?

Upgrade to a paid plan at https://www.football-data.org/pricing for:

• Higher rate limits (100 req/min or more)
• Access to more competitions
• Historical data
• Commercial usage rights

Troubleshooting

"Invalid API key"

• Verify your API key is correct
• Make sure you've verified your email address
• Check that your API key hasn't expired

"API rate limit exceeded"

• Free tier allows 10 requests/minute
• Wait 60 seconds before trying again
• Consider caching results or upgrading to paid tier

"Team not found"

• Use the full official team name (e.g., "Chelsea FC" not "Chelsea")
• Check spelling and capitalization
• Some teams might not be in the covered leagues

"No fixtures found"

• Team might not have scheduled matches in the date range
• Try extending the date range
• Remove competition filter to see all fixtures

Resources

• Football-Data.org Documentation
• Register for Free API Key
• API Pricing Plans

License

Apache-2.0