Skip to main content

​
Base URL

https://v2.football.sportsapipro.com

​
Live Data

​
Live Scores

GET /api/live
Returns all currently live matches with simplified score data, match status, and minute. Use this as the primary source for discovering live match IDs.

​
All Live Events

GET /api/live/all
Returns all live events unfiltered with full raw data (more verbose than /api/live).

​
Today’s Matches

GET /api/today
Returns all matches scheduled for today across all competitions. 
GET /api/trending
Returns the top 20 events sorted by attendance and popularity — great for featuring “hot” matches. 
GET /api/trending-players
Returns currently trending players based on recent performance and media attention.

​
Live Tournaments

GET /api/live-tournaments
Returns tournaments that currently have live matches in progress. Useful for building a sidebar of active competitions.

​
Newly Added Events

GET /api/newly-added-events
Returns recently added fixtures that weren’t previously in the schedule (e.g., rescheduled matches, cup draws).

​
Search All

GET /api/search?q={query}
Search across teams, players, and tournaments simultaneously. Returns entity IDs that can be used with other endpoints.
​
q
string
required
Search query (e.g., arsenal, messi, premier league). Minimum 2 characters.
This is the primary way to discover entity IDs for teams, players, and tournaments when you don’t have them from another API call.

​
Schedule

​
Events by Date

GET /api/schedule/{date}
Returns all matches for a specific date, grouped by tournament.
​
date
string
required
Date in YYYY-MM-DD format (e.g., 2025-03-15).

​
Scheduled Tournaments by Date

GET /api/scheduled-tournaments/{date}
Returns tournaments that have matches on a specific date — useful for building a competition filter.
​
date
string
required
Date in YYYY-MM-DD format.

​
Event Count

GET /api/event-count
Returns a global count of events across all sports and competitions.

​
Countries & Categories

​
All Countries

GET /api/countries
Returns all countries with basic info (name, code, flag URL).

​
All Countries (Extended)

GET /api/countries/all
Returns all countries with subcategories and additional metadata.

​
Category Tournaments

GET /api/categories/{categoryId}/tournaments
Returns all tournaments within a specific category (country or region).
​
categoryId
number
required
Category ID from the countries endpoint.

​
Country Flag

GET /api/country/{code}/flag
Returns the flag image URL for a country code.
​
code
string
required
Two-letter country code in uppercase (e.g., GB, US, DE).

​
Leagues

​
All Leagues

GET /api/leagues?country={country}&refresh={refresh}
Returns all leagues grouped by country. Useful for building a competition browser.
​
country
string
Optional country slug to filter leagues (e.g., england, spain).
​
refresh
boolean
Set to true to bypass cache and get fresh data.

​
All Tournaments (Flat)

GET /api/tournaments?refresh={refresh}
Returns all tournaments as a flat list (not grouped by country).

​
Tournament Seasons

GET /api/tournaments/{id}/seasons
Returns all available seasons for a tournament. See Tournament Endpoints for season-specific data.

​
News

​
Sports News

GET /api/news?lang={lang}
Returns the latest sports news articles.
​
lang
string
default:"en"
Language code (e.g., en, es, de, fr, pt, it).

​
Example Requests

# Search for a team
curl -X GET "https://v2.football.sportsapipro.com/api/search?q=arsenal" \
  -H "x-api-key: YOUR_API_KEY"

# Get today's schedule
curl -X GET "https://v2.football.sportsapipro.com/api/schedule/2025-03-15" \
  -H "x-api-key: YOUR_API_KEY"