fiba-scraper

Scrapes official FIBA international basketball game results and group standings from fiba.basketball — World Cup, EuroBasket, Olympic qualifiers, and many more competitions. No login required.

Contents

• Key features
• Important: recency limitation
• Output
• Input
• Input examples
• Incremental (delta) mode
• How to scrape fiba.basketball
• FAQ

🔑 Key features

• Two entity types, one Actor. Set entityType to games (score-by-score results) or standings (group standings — rank, wins/losses, points for/against).
• Official federation data — real results and standings, not estimates, across international competitions FIBA itself organizes.
• Delta mode built in. Every run classifies each item as new, changed, unchanged, or delisted against a persisted baseline.
• maxItems defaults to 50 — a fast preview, and what keeps an unconfigured run within Apify's automated 5-minute QA check. Clear maxItems (null) for a full run.

⚠️ Important: recency limitation

Only recent competitions (roughly 2025 onward, confirmed live) have real results/standings data. Older, archived competitions (checked live: the 2024 Paris Olympics, the 2023 World Cup) return no real data for this Actor — a real limitation of FIBA's own site (older events don't embed real game data the way recent ones do), not a bug here. A full crawl will still examine every competition in FIBA's real events list (~200), it just won't find anything for the older ones.

📋 Output

One dataset item per game (games) or per team-per-group standing (standings) — see .actor/dataset_schema.json for the full field list, or the Output tab's Games / Standings views for a readable table.

Example game record:

{
  "source": "fiba",
  "entity_type": "games",
  "external_id": "128186",
  "url": "https://www.fiba.basketball/en/events/fiba-womens-basketball-world-cup-2026-qualifying-tournament-wuhan-china/games",
  "event_name": "Fiba Womens Basketball World Cup 2026 Qualifying Tournament Wuhan China",
  "team_a_name": "China",
  "team_a_score": 81,
  "team_b_name": "Mali",
  "team_b_score": 68,
  "status_code": "VALID",
  "venue_name": "Wuhan Sports Centre",
  "host_city": "Wuhan",
  "game_date": "2026-03-11T19:30:00",
  "change_type": "new"
}

Example standing record:

{
  "source": "fiba",
  "entity_type": "standings",
  "external_id": "fiba-afrobasket-2025-283381",
  "url": "https://www.fiba.basketball/en/events/fiba-afrobasket-2025/standings",
  "event_name": "Fiba Afrobasket 2025",
  "rank": 1,
  "team_name": "Côte d'Ivoire",
  "games_played": 3,
  "games_won": 3,
  "games_lost": 0,
  "points_for": 235,
  "points_against": 214,
  "change_type": "new"
}

🔧 Input

Field	Type	Default	Description
entityType	string	games	games or standings.
maxItems	integer	50	Stop after pushing this many items. Set to null for a full crawl.
mode	string	auto	auto / full / incremental — see Incremental mode.
concurrency	integer	10	How many competition pages to fetch in parallel.
impersonate	string	chrome	curl_cffi TLS-impersonation target — required, see FAQ.
proxyConfiguration	object	off	Apify Proxy config — not needed under normal use.

📥 Input examples

Default preview (50 games):

{ "entityType": "games" }

Full crawl of standings across every real competition:

{ "entityType": "standings", "maxItems": null }

🔁 Incremental (delta) mode

auto mode does a full scan the first time it runs for a given entityType, then only pushes new/changed items on later runs. Only an uncapped, error-free run can detect delistings or update the baseline — useful for tracking an ongoing competition as new games are played.

🌐 How to scrape fiba.basketball

FIBA's own site embeds real, complete game and standings data directly in its server-rendered pages for recent competitions — this Actor reads that embedded data, the same content a browser receives, just automated and exhaustive across FIBA's real events list.

❓ FAQ

Why does this need impersonate: "chrome"? fiba.basketball sits behind a WAF that hard-blocks non-browser HTTP requests outright — confirmed live even on robots.txt. A browser TLS fingerprint clears it completely, no proxy needed.

Why is data missing for older competitions? See Important: recency limitation above — a real, confirmed site limitation, not a bug in this Actor.

Does standings include team names? Yes — FIBA's own standings data only carries a numeric team id, so this Actor cross-references each competition's own game data (which does carry full team names) to resolve them.