# Football (Israel) — 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 Israeli football league standings, fixtures, and team performance with comprehensive data on leagues, squads, and player statistics. Get detailed match information, top scorers, and team-specific stats to stay updated on the Israeli football season.

**Category:** Sports | **Website:** [football.co.il/](https://football.co.il/) | **Docs:** [parse.bot/marketplace/31221610-43fa-459b-9425-0d2ab910a2c4/football-co-il-api](https://parse.bot/marketplace/31221610-43fa-459b-9425-0d2ab910a2c4/football-co-il-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-football-co-il-api-31221610/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_teams

Get all teams in the league. Returns the full team list with multilingual names, colors, stadium IDs, and coach names.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_all_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_fixtures_by_matchday

Get fixtures and results for a specific matchday (round). If matchday is omitted, returns the latest played matchday. Each fixture contains expanded team and stadium detail objects.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `matchday` | string | No | Matchday number (e.g., '1', '10', '26'). If omitted, returns the latest played matchday. |
| `season` | string | No | Season identifier in YY/YY format. |
| `tournament_id` | string | No | Tournament ID. '902' for Ligat Ha'Al, '719' for Liga Leumit. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_fixtures_by_matchday \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"matchday":"<string>","season":"<string>","tournament_id":"<string>"}'
```

### get_league_standings

Get league standings for a specific tournament and season. Returns standings grouped by stage (RegularSeason, ChampionshipRound, RelegationRound). Each stage contains an array of team standings sorted by position.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Season identifier in YY/YY format (e.g., '25/26', '24/25'). |
| `tournament_id` | string | No | Tournament ID. '902' for Ligat Ha'Al (top division), '719' for Liga Leumit. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_league_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","tournament_id":"<string>"}'
```

### get_match_details

Get full details for a specific match. Returns match data including expanded team objects, scores, date, stadium, and status. The game is looked up from the round data, so both played and upcoming matches are supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID (e.g., '285266'). Discoverable from get_fixtures_by_matchday or get_team_fixtures. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_match_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>"}'
```

### get_match_statistics

Get in-game team-level statistics for a specific match. Returns stats for both teams as a list, including goals, expected goals, passes, possession, shots, and more.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID. Discoverable from get_fixtures_by_matchday or get_team_fixtures. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_match_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>"}'
```

### get_player_stats_leaders

Get season aggregate statistics for all players. Returns per-player stats including goals, assists, appearances, expected goals, passes, and more.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Season identifier in YY/YY format. |
| `tournament_id` | string | No | Tournament ID. Player stats are reliably available for '902' (Ligat Ha'Al). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_player_stats_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","tournament_id":"<string>"}'
```

### get_team_fixtures

Get all fixtures for a specific team across all seasons. Returns a list of fixture objects with expanded team and stadium details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | Team ID. Use get_all_teams to discover valid IDs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_team_fixtures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>"}'
```

### get_team_profile

Get profile for a specific team. Returns detailed team info including stadium as an expanded object with name and multilingual names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | Team ID (e.g., '4536' for Maccabi Tel Aviv, '4539' for Maccabi Haifa). Use get_all_teams to discover valid IDs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_team_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>"}'
```

### get_team_squad

Get player roster for a specific team. Returns all players with position, shirt number, date of birth, and full career club history.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | Team ID. Use get_all_teams to discover valid IDs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_team_squad \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>"}'
```

### get_team_statistics

Get season aggregate statistics for a team. Returns a list containing team-level stats such as goals, expected goals, passes, ball possession, and more.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Season identifier in YY/YY format. |
| `team_id` | string | Yes | Team ID. Use get_all_teams to discover valid IDs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_team_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","team_id":"<string>"}'
```

### get_top_scorers

Get list of top scorers in the league, sorted by goals descending. Returns per-player stats including goals, assists, appearances, and expected goals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Season identifier in YY/YY format. |
| `tournament_id` | string | No | Tournament ID. Scorer data is reliably available for '902' (Ligat Ha'Al). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-football-co-il-api-31221610/get_top_scorers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","tournament_id":"<string>"}'
```