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

> Get live football scores, match details, team standings, and player statistics in real-time. Stay updated with the latest football news and competition rankings all in one place.

**Category:** Sports | **Website:** [kooora.com/](https://kooora.com/) | **Docs:** [parse.bot/marketplace/bba0f398-305a-4092-826a-3c59bae6cd45/kooora-com-api](https://parse.bot/marketplace/bba0f398-305a-4092-826a-3c59bae6cd45/kooora-com-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-kooora-com-api-bba0f398/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_live_match

Get a currently live match involving the specified team. Searches today's matches on kooora.com for one with status LIVE that matches the team name. Returns match details including score, current minute, competition, venue, and match events (goals, yellow/red cards, substitutions) extracted from lineups data. Returns null data when no live match is found for the team.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_name` | string | Yes | The team name to search for, in Arabic (e.g. 'الوداد الرياضي', 'ريال مدريد') or as it appears on kooora.com. Partial matches are supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_live_match \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"<string>"}'
```

### get_matches

Get football match schedules and live scores for the current day. Returns matches grouped by competition. Each competition contains its name, ID, and an array of matches with team names, scores, status, venue, and live period information. Matches with status 'FIXTURE' have not started; other statuses indicate live or completed states.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news

Get recent sports news articles from kooora.com. Returns up to 30 articles with titles, teasers, publication timestamps, images, URLs, and tags. Articles are ordered by most recent first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_player_stats

Get profile information for a specific football player including name, position, age, nationality, and current team. Player IDs can be found in competition pages and match data on kooora.com. The endpoint returns biographical and career data for the player.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | The unique alphanumeric ID of the player. Player IDs can be found in competition and match pages on kooora.com. |

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

### get_standings

Get team standings for a specific football competition. Returns one or more tables of team rankings with position, team details, matches played, wins, draws, losses, goals for/against, goal difference, and points. Some competitions have multiple groups, each returned as a separate table. Competition IDs can be obtained from the get_matches endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | Yes | The unique alphanumeric ID of the competition. Obtainable from the competition_id field in get_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competition_id":"<string>"}'
```

### get_team

Get profile information for a specific football team. Searches kooora.com's team database by name (Arabic or English). Returns team identity (ID, name, logo), current league/competition details, and founded year when available. The competition shown is the team's primary domestic league.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_name` | string | Yes | The team name to search for, in Arabic (e.g. 'الوداد الرياضي', 'ريال مدريد') or as it appears on kooora.com. Partial matches are supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_team \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"<string>"}'
```

### get_team_dashboard

Get a unified team dashboard aggregating profile information, the next upcoming match, the most recent completed match, and up to 5 latest news articles for the specified team. Searches kooora.com's team database by name (Arabic or English). Combines data from the team's matches page and news page into a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_name` | string | Yes | The team name to search for, in Arabic (e.g. 'الوداد الرياضي', 'ريال مدريد') or as it appears on kooora.com. Partial matches are supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_team_dashboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"<string>"}'
```

### get_team_matches

Get recent completed matches and upcoming fixtures for a specific football team. Searches kooora.com's team database by name (Arabic or English). Returns up to 10 most recent completed matches and up to 10 nearest upcoming fixtures with team details, scores, competition info, and venue.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_name` | string | Yes | The team name to search for, in Arabic (e.g. 'الوداد الرياضي', 'ريال مدريد') or as it appears on kooora.com. Partial matches are supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_team_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"<string>"}'
```

### get_team_news

Get recent news articles for a specific football team from kooora.com. Searches the team database by name (Arabic or English) and returns up to 30 articles ordered by most recent first. Each article includes title, teaser, publication date/time, image, URL, and display tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_name` | string | Yes | The team name to search for, in Arabic (e.g. 'الوداد الرياضي', 'ريال مدريد') or as it appears on kooora.com. Partial matches are supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kooora-com-api-bba0f398/get_team_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_name":"<string>"}'
```