PHP Padel Tournament API Server

This server provides both a web interface and REST API endpoints for padel tournament data, serving static tournament and club data from local JSON files.

Available Interfaces

🏓 Tournament Map 🏓 Clubs Map 👥 Players 📊 Live Scores 🎾 Create Match 📚 API Documentation 🔧 System Diagnostics

API Endpoints

GET

/v1/tournaments

Get all tournament data with optional filtering by date, ranking, game type, and location

Examples:

curl "https://api.playpadel.be/v1/tournaments"
curl "https://api.playpadel.be/v1/tournaments?start_date=2025-11-01&ranking=100"

GET

/v1/tournament/{id}

Get detailed information for a specific tournament

Example:

curl "https://api.playpadel.be/v1/tournament/115287"

GET

/v1/statsplayers?s={search_term}

Search for players by name

Example:

curl "https://api.playpadel.be/v1/statsplayers?s=john"

GET

/v1/statsplayer/{player_id}

Get detailed player information

Example:

curl "https://api.playpadel.be/v1/statsplayer/12345"

GET

/v1/players?s={search_term}

Get all players from all clubs with pagination support, optionally searchable by player name, club name, ranking, or category (page_size parameter required, minimum 10)

Examples:

curl "https://api.playpadel.be/v1/players?page_size=50"
curl "https://api.playpadel.be/v1/players?s=john&page_size=25"
curl "https://api.playpadel.be/v1/players?s=antwerp&page_size=25"
curl "https://api.playpadel.be/v1/players?s=100&page_size=25"
curl "https://api.playpadel.be/v1/players?s=M&page_size=25&page_number=2"

GET

/v1/player/{id}

Get detailed information for a specific player, including club details and player statistics

Example:

curl "https://api.playpadel.be/v1/player/12345"

GET

/v1/clubs

Get summary information for all clubs

Example:

curl "https://api.playpadel.be/v1/clubs"

GET

/v1/club/{club_name}

Get detailed information for a specific club

Example:

curl "https://api.playpadel.be/v1/club/PADELLAND"

GET

/v1/news

Get tournament news and updates, including recent changes, new tournaments, and player movements

Example:

curl "https://api.playpadel.be/v1/news"

Query Parameters for Tournaments

start_date, end_date: Date range (DD/MM/YYYY or YYYY-MM-DD format)
ranking: Filter by ranking level (50, 100, 200, 300, 400, 500, 700, 1000)
gametype: Filter by game type (HEREN, DAMES, GEMENGD)
lat, lng, radius: Location-based filtering (requires all three)

Query Parameters for Players

s (optional): Search term to filter players by name, club name, ranking, or category
page_size (required): Number of players per page (minimum: 10, maximum: 1000)
page_number (optional): Page number to retrieve (default: 1, minimum: 1)

Data Sources

Tournament data: data/tournaments_all_*.json
Club player data: data/clubs/club_players_*.json
Location data: data/clubs_padelstats_meta.csv