fiba.basketball APIfiba.basketball ↗
Access FIBA game schedules, scores, quarter-by-quarter breakdowns, world rankings, competition lists, and news search via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/cc3c1c14-45b1-403f-b470-f208c37a6108/get_games_by_date?date=2026-04-20' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve game schedule and results for a specific date. Returns an array of games scheduled for that date, which may be empty if no games are scheduled. Each game includes team information, scores, venue, and competition details.
| Param | Type | Description |
|---|---|---|
| date | string | Target date in YYYY-MM-DD format. If omitted, defaults to today's date. |
{
"type": "object",
"fields": {
"data": "array of game objects, each containing gameId, teamA, teamB, teamAScore, teamBScore, statusCode, hostCity, hostCountry, venueName, gameDateTime, competition, and round details. May be empty if no games are scheduled for the given date.",
"status": "string indicating success"
},
"sample": {
"data": [
{
"teamA": {
"code": "FUS",
"teamId": 284667,
"shortName": "F.U.S de Rabat",
"officialName": "Fath Union Sport",
"organisationId": 8958
},
"teamB": {
"code": "JCA",
"teamId": 284670,
"shortName": "JCA Kings",
"officialName": "JCA Kings",
"organisationId": 66028
},
"gameId": 134181,
"isLive": false,
"gameName": "30975-A-7",
"hostCity": "Rabat",
"venueName": "Salle Omnisports Moulay Abdellah",
"statusCode": "INIT",
"teamAScore": 0,
"teamBScore": 0,
"hostCountry": "Morocco",
"gameDateTime": "2026-04-24T19:00:00"
}
],
"status": "success"
}
}About the fiba.basketball API
This API exposes 5 endpoints covering FIBA international basketball data: game schedules by date, detailed per-game breakdowns, active competition listings, world rankings across four categories, and keyword-searchable news articles. The get_game_detail endpoint, for example, returns period-by-period scores, referee nominations, venue information, and game status — all keyed by a GDAP Game ID retrieved from get_games_by_date.
Game Schedule and Detail
get_games_by_date accepts a date parameter in YYYY-MM-DD format (defaults to today if omitted) and returns an array of game objects. Each object includes gameId, teamA, teamB, teamAScore, teamBScore, statusCode, hostCity, hostCountry, and venueName. That gameId feeds directly into get_game_detail, which adds a periods array of quarter-by-quarter scores and a nominations array of officials. Games not yet played return empty periods entries and a statusCode of INIT.
Competitions and World Rankings
get_competition_list returns all active and calendar-status FIBA competitions with fields including slug, title, event (the event ID string), fibaOfficialName, gender, eventDateStart, eventDateEnd, and zone. No parameters are required. get_world_rankings accepts a category value of men, women, boys, or girls and returns each country's worldRank, countryName, currentPoints, and worldRankVariation. Note that results are not guaranteed to arrive pre-sorted by rank; client-side sorting on worldRank is necessary for ordered display.
News Search
search_news takes a required query string and an optional limit integer. Matching articles include title, description, date, slug, id, and @search.score — a relevance float you can use to rank results client-side. This is useful for building topic feeds around specific tournaments, teams, or players mentioned in FIBA coverage.
- Display today's FIBA game schedule and live scores on a basketball dashboard using
get_games_by_date - Build a box-score view with quarter-by-quarter breakdowns from
get_game_detailperiods data - Track FIBA men's and women's world rankings over time using
worldRankandworldRankVariationfields - List upcoming FIBA tournaments by zone and gender from
get_competition_listevent data - Aggregate FIBA news articles by keyword for a topic-specific feed using
search_newswith@search.scorerelevance ranking - Alert users to referee assignments for specific games via
nominationsdata inget_game_detail - Cross-reference game results with competition slugs for tournament bracket tracking
| 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.
Does FIBA offer an official public developer API?+
What does `get_game_detail` return for a game that hasn't been played yet?+
periods array is returned empty and the statusCode field is set to INIT. Team info, venue, and competition context are still populated where available, so you can use the endpoint to pre-populate fixture displays before tip-off.Does `get_world_rankings` return results in ranked order?+
worldRank integer is included in each object, but results are not guaranteed to arrive sorted. Sort the returned array client-side on worldRank ascending to get the correct order.Are player-level statistics or individual box scores available?+
Can I filter `get_competition_list` by zone, gender, or status?+
gender, zone, and status fields, so you can filter client-side. You can fork this API on Parse and revise it to add server-side filtering parameters.