Welcome to Goalise Football API
Goalise provides reliable football data tailored for developers who need live, historical, and prediction insights for football matches across leagues worldwide.
Whether you're building a fantasy football app, sports analytics dashboard, or just need football data, Goalise has you covered.
🧩 What to do with Goalise?
- Retrieve live match scores, events, odds and statistics.
- Access team and player statistics, including form and goals.
- Fetch league standings, top scorers, and matches by season.
- Use advanced prediction endpoints for future matches.
- Filter data by league, team, season, or match ID.
- For more things you can do, see API Reference section.
🚀 Quick Start
To start using the Goalise API:
Subscribe to a pricing plan
Choose your plan and billing period.Get Your API Key
Once subscribed, your API key will be available under your dashboard.Make Your First Request
Here's an example using curl:
curl -X GET "https://api.goalise.com/api/v2/matches?league_id=618&season=2024" \
-H "Authorization: Bearer YOUR_API_TOKEN"📚 API Reference
A quick overview of available API endpoint groups:
🌍 Countries
List of all supported countries with flags and codes. Use the available_leagues property from country object to check if the country has leagues in our API.
🏆 Leagues
All competitions by country, including seasons, rounds, and detailed information.
🏟️ Teams
Club and national teams including statistics and detailed info.
👤 Players
Players with personal data, stats, transfers, ratings and more.
📅 Matches
Scheduled and live matches with status, score, lineup, events and statistics.
Match Status Codes
List of possible short match status codes used in the API:
| Code | Description |
|---|---|
| TBD | Scheduled but date and time are not known |
| NS | Match is scheduled and has not started |
| 1H | First half is in progress |
| HT | Match is at halftime |
| 2H | Second half is in progress |
| ET | Extra time is being played |
| BT | Break during extra time |
| P | Penalty shootout is in progress |
| SUSP | Suspended by referee’s decision, may be rescheduled |
| INT | Match interrupted temporarily, should resume shortly |
| FT | Match finished in regular time |
| AET | Match finished after extra time |
| PEN | Match finished after penalties |
| PST | Postponed to a later date |
| CANC | Cancelled and will not be played |
| ABD | Abandoned before completion (e.g., weather, safety) |
| AWD | Technical loss awarded (not played) |
| WO | WalkOver — opponent forfeited |
| LIVE | In progress but detailed timing not available |
📊 Standings
League tables with rankings, points, form, etc.
⚽ Events
In-match events like goals, cards, substitutions.
📈 Statistics
Detailed match stats per team and player.
🔁 Transfers
Player transfer history and current market data.
🧠 Predictions
Match outcome predictions and tips.
🎯 Odds
Bookmaker odds and live odds for each match.
📹 Video Highlights
Match video highlights (will be available soon).
🏅 Top Scorers
List of top players by goals, assists, cards, etc.
🗓️ Seasons
All available seasons per league.
🌐 Coverage
Check which data features are available for each league. Coverage are included in league objects.
📰 News
Latest football news, articles, and updates by date, team, league or category.
🏟️ Venues
Stadium information including name, location, capacity, and surface type.
Explore all available endpoints in the API Reference section.
💡 Tips
- All parameters are case-sensitive.
- Use
id,team_id,league_id, andseasonwhen available to filter data efficiently. - Follow rate limits defined by your subscription to avoid being blocked.
Still have questions? Visit the Support or contact us directly.
Happy coding! ⚽️