# Ogol — 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.

> Search and explore comprehensive data on Brazilian women's football players, including detailed profiles, match histories, season statistics, achievements, and club rosters all in one place. Find any player's career information, honors, and performance logs to stay updated on Brazil's women's football scene.

**Category:** Sports | **Website:** [www.ogol.com.br/](https://www.ogol.com.br/) | **Docs:** [parse.bot/marketplace/20e40ea6-4dc1-4fea-a3fc-59462edef52b/ogol-com-br-api](https://parse.bot/marketplace/20e40ea6-4dc1-4fea-a3fc-59462edef52b/ogol-com-br-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-ogol-com-br-api-20e40ea6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### club_squad

Retrieve the squad list for a club in a given season. Each entry includes shirt number, player name, age, nationality, player_id, and position group.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | Yes | Season identifier (epoca_id). Use 155 for 2025/2026 season. |
| `team_id` | string | Yes | Numeric team ID. Can be found via team search or player profile links. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ogol-com-br-api-20e40ea6/club_squad \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","team_id":"<string>"}'
```

### player_honours

Retrieve titles (títulos) won by a player. Each entry lists the competition name (preserved in Portuguese), club, and season year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Numeric player ID from search_player results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ogol-com-br-api-20e40ea6/player_honours \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### player_match_log

Retrieve match-by-match log for a player in a given season. Each match includes date, competition, club, opponent, score, minutes played, goals (counted from icons), assists, result (V/E/D), round, home/away, starter/substitute/unused status, yellow/red cards. Also returns a season summary (resumo_totals) with per-competition breakdowns and header aggregates from the page. When the player has recorded activity for the season but no match-level data is available, data_status is 'no_data_for_season'; otherwise 'ok'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Numeric player ID from search_player results. |
| `season` | string | Yes | Season identifier (epoca_id). Use 155 for 2025/2026 season. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ogol-com-br-api-20e40ea6/player_match_log \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>","season":"<string>"}'
```

### player_profile

Retrieve full biographical profile for a player including birth date, birthplace, position, preferred foot, height/weight, active status (situação), national team caps, and current club.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Numeric player ID from search_player results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ogol-com-br-api-20e40ea6/player_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### player_season_by_season

Retrieve season-by-season career statistics for a player. Each entry shows season year, club, squad level (e.g. [S20], [S17], [Feminino] for youth/women's squads), total games (jogos), goals (gols), and assists (assistências). Players with multiple squad appearances in the same season produce separate records per squad. Also includes national team totals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Numeric player ID from search_player results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ogol-com-br-api-20e40ea6/player_season_by_season \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### search_player

Search for football players by name across all ogol.com.br listings (men/women, senior/youth, all leagues). Returns a list of matching players with their IDs, positions, and nationalities. Results are ordered by popularity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Player name or partial name to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ogol-com-br-api-20e40ea6/search_player \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```