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

> Track live scores and detailed statistics across football, hockey, basketball, tennis, and cricket with the ability to filter by date, sport, and league. Access match summaries, team overviews, standings, fixtures, and results to stay updated on your favorite competitions and teams.

**Category:** Sports | **Website:** [livescore.com/](https://livescore.com/) | **Docs:** [parse.bot/marketplace/6bb3cbaa-1793-4fa6-b9c8-fcaeafb8150b/livescore-com-api](https://parse.bot/marketplace/6bb3cbaa-1793-4fa6-b9c8-fcaeafb8150b/livescore-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-livescore-com-api-6bb3cbaa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_football_scores_by_date

Returns football matches for a specific date. Equivalent to calling get_scores_by_date_and_sport with sport=football and the given date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_football_scores_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### get_league_fixtures

Returns upcoming scheduled fixtures for a specific football league. The response contains initialData with sections array (may be null if no upcoming fixtures), header with competition details, and activeTabId set to fixtures.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country slug where the league is based (e.g. england, netherlands, italy, spain, germany, france). Must be a real country, not a competition slug. |
| `league` | string | Yes | League slug (e.g. premier-league, eredivisie, serie-a, laliga-santander, bundesliga, ligue-1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_league_fixtures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","league":"<string>"}'
```

### get_league_overview

Returns overview info for a football league including today's fixtures, recent results, standings snippet, and top scorer stats. The response includes pageProps with initialData containing tables, sections with recent events, and player/team goal stats.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country slug where the league is based (e.g. england, netherlands, italy, spain, germany, france). Must be a real country, not a competition slug. |
| `league` | string | Yes | League slug (e.g. premier-league, eredivisie, serie-a, laliga-santander, bundesliga, ligue-1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_league_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","league":"<string>"}'
```

### get_league_results

Returns past match results for a football league. The response contains initialData with sections array holding recent completed events for the competition.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country slug where the league is based (e.g. england, netherlands, italy, spain, germany, france). Must be a real country, not a competition slug. |
| `league` | string | Yes | League slug (e.g. premier-league, eredivisie, serie-a, laliga-santander, bundesliga, ligue-1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_league_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","league":"<string>"}'
```

### get_league_standings

Returns the current league table/standings for a football competition. Attempts to use the direct standings API first, falling back to page data. The response contains team rankings with points, wins, draws, losses, and goal information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country slug where the league is based (e.g. england, netherlands, italy, spain, germany, france). Must be a real country, not a competition slug. |
| `league` | string | Yes | League slug (e.g. premier-league, eredivisie, serie-a, laliga-santander, bundesliga, ligue-1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_league_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","league":"<string>"}'
```

### get_league_stats

Returns top-scorer and other player leaderboards for a football league. Includes goals, assists, shots on target, big chances created, and more stat categories with player rankings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country slug where the league is based (e.g. england, netherlands, italy, spain, germany, france). Must be a real country, not a competition slug. |
| `league` | string | Yes | League slug (e.g. premier-league, eredivisie, serie-a, laliga-santander, bundesliga, ligue-1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_league_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","league":"<string>"}'
```

### get_match_summary

Returns match event timeline, statistics, lineups, and more for a specific match. Includes incidents (goals, cards), scores by period, streaming media information, and head-to-head data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country slug (e.g. england). |
| `league` | string | Yes | League slug (e.g. premier-league). |
| `match_id` | string | Yes | Numeric match ID (e.g. 1529150). Obtainable from league results or fixtures endpoints. |
| `match_slug` | string | Yes | Match slug in format home-vs-away (e.g. chelsea-vs-nottingham-forest). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_match_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","league":"<string>","match_id":"<string>","match_slug":"<string>"}'
```

### get_scores_by_date_and_sport

Returns all matches for a given sport on a specific date, grouped by competition/league. Each stage contains an Events array with match details including teams, scores, and status. Supports football, hockey, basketball, tennis, and cricket. Defaults to football and today's date when parameters are omitted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD or YYYYMMDD format. Defaults to today (UTC). |
| `sport` | string | No | Sport name. Accepted values: football, hockey, basketball, tennis, cricket. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_scores_by_date_and_sport \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","sport":"<string>"}'
```

### get_team_overview

Returns a football team's overview including next match, recent results, form, and player/team statistics. Provides team header info, competition stats, and upcoming fixture data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | Numeric team ID (e.g. 2810 for Manchester United). Obtainable from search_teams_and_competitions. |
| `team_slug` | string | Yes | Team slug (e.g. manchester-united, ajax, liverpool). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/get_team_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>","team_slug":"<string>"}'
```

### get_todays_football_scores

Returns all of today's football matches across all leagues. Equivalent to calling get_scores_by_date_and_sport with sport=football and today's date. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### get_tomorrows_football_fixtures

Returns all football fixtures scheduled for tomorrow (UTC). Equivalent to calling get_scores_by_date_and_sport with sport=football and tomorrow's date. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### search_teams_and_competitions

Search for teams or competitions by name. Returns matching teams with ID, name, country, and badge info, plus matching competition stages. Use team IDs from results with get_team_overview.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. Manchester, Ajax, Premier League). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-livescore-com-api-6bb3cbaa/search_teams_and_competitions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```