# Rib.gg — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive Valorant competitive data including match results, player statistics, team information, and tournament details with powerful search and filtering capabilities. Track player performance history, view rankings, discover free agents, and analyze in-depth match rounds and analytics all in one place.

**Category:** Sports | **Website:** [rib.gg/](https://rib.gg/) | **Docs:** [parse.bot/marketplace/81d64572-58ed-408e-a5a6-62d1ece3aea7/rib-gg-api](https://parse.bot/marketplace/81d64572-58ed-408e-a5a6-62d1ece3aea7/rib-gg-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_event_details

Get event participants (teams and player rosters) and analytics including top players by ACS, top teams, map pick rates, and per-agent aggregate stats. Future events with no completed matches will return empty analytics arrays.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | integer | Yes | Event ID (from get_events_list). Use events with seriesCount > 0 for populated analytics. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<integer>"}'
```

### get_events_list

Get a list of Valorant events and tournaments with pagination. Events are sorted by start date descending and include prize pool, region, and parent event information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `start` | integer | No | Offset for pagination. |
| `take` | integer | No | Number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_events_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"<integer>","take":"<integer>"}'
```

### get_free_agents

Get a list of free agents (players recently released from teams) with their career performance stats including matches played, kills, deaths, ACS, ADR, and average ratings. Sorted by release date descending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_free_agents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_match_details

Get detailed map-level statistics for a specific match including per-player stats (kills, deaths, assists, score), round events (kills, plants, defuses, revivals), player locations, and economy data per round.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | integer | Yes | Match ID (from series matches array in get_matches_results or get_matches_schedule). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_match_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<integer>"}'
```

### get_match_rounds

Get round-by-round events for a match, organized by round number. Each round contains an array of events (kills, plants, defuses, revivals). Derived from the same match details endpoint but restructured by round.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | integer | Yes | Match ID (from series matches array in get_matches_results or get_matches_schedule). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_match_rounds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<integer>"}'
```

### get_matches_results

Retrieve completed match results (series) with pagination and optional team/event filter. Returns paginated series data sorted by date descending. Each series contains team information and individual map matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | integer | No | Filter by event ID (from get_events_list). |
| `start` | integer | No | Offset for pagination. |
| `take` | integer | No | Number of results to return. |
| `team_id` | integer | No | Filter by team ID (from search or get_team_overview). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_matches_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<integer>","start":"<integer>","take":"<integer>","team_id":"<integer>"}'
```

### get_matches_schedule

Retrieve upcoming (not yet completed) match schedule with pagination. Returns paginated series data sorted by start date ascending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `start` | integer | No | Offset for pagination. |
| `take` | integer | No | Number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_matches_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"<integer>","take":"<integer>"}'
```

### get_player_analytics

Get advanced player analytics including top weapons with aim breakdown, overall aim stats (headshots/bodyshots/legshots), weekly aim timeline, basic aggregate stats, per-map win/loss records, and situational XvY performance over a configurable time window.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | integer | No | Number of days to look back for analytics. |
| `player_id` | integer | Yes | Player ID (from search results or team roster). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_player_analytics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<integer>","player_id":"<integer>"}'
```

### get_player_match_history

Get a player's series (match) history with pagination. Returns series the player participated in, including both completed and upcoming matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | integer | Yes | Player ID (from search results or team roster). |
| `start` | integer | No | Offset for pagination. |
| `take` | integer | No | Number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_player_match_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<integer>","start":"<integer>","take":"<integer>"}'
```

### get_player_overview

Get player agent usage statistics over a configurable time window. Returns per-agent breakdowns of matches played, wins, rounds, kills, deaths, assists, ACS, and ADR. Small day values may return empty results for less active players.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | integer | No | Number of days to look back for stats. |
| `player_id` | integer | Yes | Player ID (from search results or team roster). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_player_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<integer>","player_id":"<integer>"}'
```

### get_rankings

Get global team rankings for the Americas region. Returns a ranked list of teams ordered by Elo rating descending. Derived from server-rendered page data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_team_overview

Get team profile including current roster (players and coaches), transaction history, Elo rating history by division (VCT, VCL, GC, T3, UNI), and ranking history. The team object contains full member details with social links and join dates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | integer | Yes | Team ID (from search results or match data). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/get_team_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<integer>"}'
```

### search

Full-text search across players, teams, and events by name. Returns a flat array of results with a resultType field indicating whether each result is a team, player, or event. Hit ratings indicate match quality.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'TenZ', 'Sentinels') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rib-gg-api-81d64572/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```