kooora.com APIkooora.com ↗
Access live football scores, match schedules, team standings, player profiles, and sports news from kooora.com via a structured JSON API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/31311a02-adfe-4734-8ea5-31db2dc8e4ee/get_matches' \ -H 'X-API-Key: $PARSE_API_KEY'
Get football match schedules and live scores for the current day. Returns matches grouped by competition.
No input parameters required.
{
"type": "object",
"fields": {
"competitions": "array of objects containing competition_name, competition_id, and matches array with match details including teams, scores, status, and venue"
},
"sample": {
"data": {
"competitions": [
{
"matches": [
{
"id": "Pp4kr_HHpPaau3PnHw1Qw",
"venue": "فيلا بارك",
"status": "RESULT",
"away_team": {
"logo": "https://cdn.sportfeeds.io/sdl/images/team/crest/medium/BNAy0MWCqOxdSF4SLgCPK.png",
"name": "نوتنجهام فوريست",
"score": 0
},
"home_team": {
"logo": "https://cdn.sportfeeds.io/sdl/images/team/crest/medium/qgf3Tx9R3nphdWIS9SgyB.png",
"name": "أستون فيلا",
"score": 4
},
"start_date": "2026-05-07T19:00:00.000Z",
"live_period": null
}
],
"competition_id": "4c1nfi2j1m731hcay25fcgndq",
"competition_name": "الدوري الأوروبي"
}
]
},
"status": "success"
}
}About the kooora.com API
The Kooora.com API covers 4 endpoints that surface football data from one of the Arab world's most-visited sports sites, including live match scores grouped by competition, team standings with goal statistics, and player profiles. The get_matches endpoint returns today's fixtures and live scores organized by competition, while get_standings accepts a competition ID to retrieve full league table data with points, wins, draws, and losses.
Match Schedules and Live Scores
The get_matches endpoint returns today's football fixtures and live scores structured as an array of competition objects. Each object includes competition_name, competition_id, and a nested matches array containing team names, current scores, and match status. No parameters are required — the response always reflects the current day's data. The competition_id values returned here can be passed directly into get_standings to retrieve the corresponding league table.
League Standings
The get_standings endpoint takes a single required parameter, competition_id, and returns a standings table for that league or tournament. Each row in the rankings array includes the team's position, a team object with id, name, and logo, plus played, won, drawn, lost, goals_for, and related goal statistics. Example IDs are documented for the Premier League and other competitions; additional IDs can be discovered from get_matches responses.
Player Profiles
The get_player_stats endpoint accepts a player_id (alphanumeric string) and returns a profile object covering name, first_name, last_name, position, age, date_of_birth, shirt_number, nationality, image_url, and a nested team object. Player IDs appear in match and standings data, making the endpoints composable. Note that this endpoint surfaces profile and biographical data rather than per-season performance statistics.
Sports News
The get_news endpoint returns up to 30 recent articles from kooora.com. Each article object includes title, teaser, publish_date, publish_time, image_url, url, and tags. The endpoint requires no parameters and reflects the latest articles at the time of the request.
- Display today's Arabic-language football match schedule with live scores grouped by league
- Build a league table widget using standings data including points, wins, losses, and goal differences
- Enrich player profile pages with biographical data such as nationality, date of birth, and current team
- Aggregate recent football news headlines and teasers for a sports news feed
- Discover competition IDs from match data to programmatically query standings for multiple leagues
- Monitor match status fields to detect when live games kick off or conclude
- Tag and categorize football news articles using the tags array returned by get_news
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.