API Documentation

Access our Valorant statistics data through our REST API.

Base URL: https://valorantdatalab.com/api/

Returns overall API health and database statistics.

Example Response:
{
  "success": true,
  "data": {
    "total_matches": 7500,
    "active_users": 36000,
    "agents_tracked": 28,
    "valid_matchups": 772
  }
}

Returns data for charts and visualizations.

Parameters:
  • type - (optional) all, agent_picks, maps, win_rates, kda, regions, timeline, top_players, summary
Example:
GET /api/charts.php?type=agent_picks

Returns detailed player statistics and match history.

Parameters:
  • name - Player name (required if no puuid)
  • tag - Player tag (required if no puuid)
  • puuid - Player PUUID (alternative to name/tag)
Example:
GET /api/player.php?name=PlayerName&tag=NA1

Returns agent duo/synergy statistics.

Parameters:
  • agent - Filter by specific agent
  • map - Filter by map
  • min_games - Minimum games together (default: 30)
Example:
GET /api/synergy.php?agent=Jett&min_games=50

Returns map-specific agent performance data.

Parameters:
  • map - Specific map name
  • agent - Specific agent name
Example:
GET /api/map-stats.php?map=Haven

Returns player leaderboards by various criteria.

Parameters:
  • type - overall, agent, regional, or all
  • agent - Filter by agent (for type=agent)
  • region - Filter by region (na, eu, ap, kr)
  • min_games - Minimum games played (default: 5)
  • limit - Max results (default: 50, max: 100)
Example:
GET /api/leaderboards.php?type=agent&agent=Jett&min_games=10

Analyzes a team composition and predicts win rate.

Parameters:
  • agents - Comma-separated list of agent names (1-5)
  • map - Optional map filter
Example:
GET /api/team-analyzer.php?agents=Jett,Sova,Omen,Cypher,Sage&map=Haven

Returns rank distribution and agent performance by rank.

Response includes:
  • Rank distribution
  • Agent popularity by rank group
  • Performance stats by rank
  • Win rates by rank

Returns agent vs agent matchup data.

Parameters:
  • agent - Get matchups for specific agent
  • map - Filter by map

Get recommended agents to counter enemy team composition.

Parameters:
  • enemies - Comma-separated enemy agent names
  • map - Optional map filter
Example:
GET /api/counter-picks.php?enemies=Jett,Reyna,Sova
Rate Limits & Usage
  • No authentication required
  • Please be respectful with request frequency
  • All responses are JSON format
  • CORS enabled for all origins