Lineups API

Public read-only API for querying Valorant lineup data. No authentication or API key required. All endpoints return JSON.

Base URLhttps://battlerecap.ziadhussein.com

Rate Limit

requests per minute, per IP

Rate Limit Headers

X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset

Quick Start

# Get all Sova lineups on Bind attacking
curl "https://battlerecap.ziadhussein.com/api/v1/lineups?agent=sova&map=bind&side=attack"

# List all agents with lineup counts
curl "https://battlerecap.ziadhussein.com/api/v1/lineups/agents"

# Get all maps that have Sova lineups
curl "https://battlerecap.ziadhussein.com/api/v1/lineups/maps?agent=sova"

Endpoints

GET/api/v1/lineupsList Lineups GET/api/v1/lineups/agentsList Agents GET/api/v1/lineups/mapsList Maps GET/api/v1/lineups/:agentGet Lineups by Agent GET/api/v1/lineups/:agent/:mapGet Lineups by Agent and Map

When rate limited, the API returns 429 with a Retry-After header indicating seconds to wait.