# Fotball — 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 match scores, search matches by team, and view tournament standings and national team information from Norwegian football competitions. Track today's matches, access detailed match information, and browse regional football data all in one place.

**Category:** Sports | **Website:** [fotball.no/](https://fotball.no/) | **Docs:** [parse.bot/marketplace/c7beeaa1-6f57-4167-a0e7-7f5fd312cbd9/fotball-no-api](https://parse.bot/marketplace/c7beeaa1-6f57-4167-a0e7-7f5fd312cbd9/fotball-no-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-fotball-no-api-c7beeaa1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_match_details

Get detailed information for a specific match including title, venue, referees, and match events. Events and referees may be empty arrays for future or unplayed matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fiks_id` | string | Yes | Match FIKS ID (numeric string, e.g. '8986194'). Available from get_todays_matches or get_tournament_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fotball-no-api-c7beeaa1/get_match_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fiks_id":"<string>"}'
```

### get_todays_matches

Get all matches scheduled for a given date. Returns match details including teams, time, venue, and tournament. Defaults to today if no date specified. Results may be empty on days with no scheduled games.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `club` | string | No | Filter by club ID. |
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns today's matches. |
| `district` | string | No | Filter by district ID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fotball-no-api-c7beeaa1/get_todays_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"club":"<string>","date":"<string>","district":"<string>"}'
```

### get_tournament_matches

Get all upcoming and past matches for a specific tournament. Returns date, time, home/away teams, result (score), venue, and match ID for each fixture. For played matches, result contains the score (e.g. '2 - 1'); for upcoming matches, result is '-' and time contains the kickoff time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament` | string | Yes | Tournament slug (e.g. 'eliteserien', 'obosligaen', 'toppserien'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fotball-no-api-c7beeaa1/get_tournament_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tournament":"<string>"}'
```

### get_tournament_standings

Get league table/standings for a specific tournament. Returns position, team name, matches played, wins, draws, losses, goals, and points for each team in the table.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament` | string | Yes | Tournament slug (e.g. 'eliteserien', 'obosligaen', 'toppserien'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fotball-no-api-c7beeaa1/get_tournament_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tournament":"<string>"}'
```

### list_national_teams

List all Norwegian national teams including men's, women's, youth, and futsal teams. Returns team name, slug, and URL for each.

**Estimated cost:** Metered

_No parameters required._

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

### list_regions

List all Norwegian football regions (kretser). Returns region name and URL for each.

**Estimated cost:** Metered

_No parameters required._

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

### search_matches_by_team

Search for tournaments a team participates in for a given season. Returns tournament names, URLs, and slugs. The team_name is matched against club registrations in the Norwegian football system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season_id` | string | No | Season ID. |
| `team_name` | string | Yes | Team name to search for (e.g. 'Rosenborg', 'Aalesund', 'Viking'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fotball-no-api-c7beeaa1/search_matches_by_team \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season_id":"<string>","team_name":"<string>"}'
```