Base URL
Authentication
All requests require thex-api-key header:
About Futsal
Futsal is 5-a-side indoor football played on a hard court with a smaller, low-bounce ball. The API covers 49 countries/categories with approximately 181 matches per day — one of the highest-volume sports on the platform.Key Rules
| Feature | Detail |
|---|---|
| Players | 5 per side (4 outfield + 1 goalkeeper) |
| Match Duration | 2 × 20 minutes (stopped clock) |
| Ball | Size 4 (low bounce) |
| Substitutions | Unlimited (fly-on, fly-off) |
| Accumulated Fouls | After 5 team fouls per half → direct free kick from 10m (no wall) |
| Power Play | Goalkeeper can be substituted for extra outfield player (5v4 attack) |
| 4-Second Rule | Goalkeeper has 4 seconds to release; kick-ins/corners/free kicks within 4 seconds |
| Offside | No offside rule in futsal |
Positions
| Position | Role |
|---|---|
| Goleiro | Goalkeeper |
| Fixo | Defender (last outfield player) |
| Ala | Winger (left and right) |
| Pivô | Pivot / target player (closest to opponent’s goal) |
Key Statistics
Goals, assists, shots on/off target, fouls committed, accumulated fouls, saves, power play goals, yellow/red cards.Endpoint Categories
| Category | Count | Description |
|---|---|---|
| Live & Schedule | 7 | Real-time scores and daily schedules |
| Search & Discovery | 7 | Search teams, players, tournaments |
| Tournament / League | 22 | League tables, standings, knockouts |
| Match | 22 | Full match data, lineups, stats, odds |
| Team | 12 | Squads, form, media |
| Player | 18 | Career stats, transfers, national team stats |
| Manager / Referee / Venue | 13 | Coaches, officials, arenas |
Major Leagues
- 🇪🇸 Spain — Primera División
- 🇧🇷 Brazil — Liga Nacional de Futsal
- 🇵🇹 Portugal — Liga Placard
- 🇷🇺 Russia — Super League
- 🌍 FIFA — Futsal World Cup
Example Requests
UI Design Ideas
- Score display: Like football: “Barcelona 4-2 Inter Movistar” — goals are the scoring unit
- Period scores: Show 1st half and 2nd half separately (e.g., “2-1 / 2-1”)
- Accumulated fouls counter: Display prominently — affects gameplay at 6th foul
- Power play indicator: Show “Power Play 5v4” when team pulls goalkeeper
- Similar to football UI: Reuse football patterns but adapt for 5v5 indoor format
Sport Comparison — Futsal vs Football vs Basketball
| Feature | Futsal | Football (Soccer) | Basketball |
|---|---|---|---|
| Players per side | 5 (4 outfield + 1 goalkeeper) | 11 | 5 |
| Pitch | Indoor court, 40×20m | Grass, 100-110m | Indoor court, 28×15m |
| Match duration | 2 × 20 min (stopped clock) | 2 × 45 min | 4 × 10/12 min |
| Ball | Size 4 (low bounce) | Size 5 | Size 7 |
| Scoring | Goals (2-8 typical per team) | Goals (0-5 typical) | Points (80-120) |
| Substitutions | Unlimited (fly-on fly-off) | 3-5 (limited) | Unlimited |
| Fouls | Accumulated fouls (6th foul = penalty) | Free kicks | Personal fouls |
| Key positions | Goleiro, Fixo, Ala, Pivô | GK, DEF, MID, FWD | PG, SG, SF, PF, C |