# Fifa — 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 FIFA world rankings for men's and women's teams, browse tournament schedules and standings, access detailed match information with live timelines, and explore comprehensive player statistics and profiles. Stay updated with the latest football news and easily search across teams, players, and matches all in one place.

**Category:** Sports | **Website:** [fifa.com/](https://fifa.com/) | **Docs:** [parse.bot/marketplace/a8eb982e-ad9d-4a5b-a7c7-5e0d94d4532d/fifa-com-api](https://parse.bot/marketplace/a8eb982e-ad9d-4a5b-a7c7-5e0d94d4532d/fifa-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-fifa-com-api-a8eb982e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_match_centre

Retrieve matches scheduled or played within a given date range. Returns matches across all FIFA competitions with teams, scores, stadiums, and status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_date` | string | Yes | Start date in YYYY-MM-DD format. |
| `to_date` | string | Yes | End date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fifa-com-api-a8eb982e/get_match_centre \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from_date":"<string>","to_date":"<string>"}'
```

### get_match_detail

Retrieve detailed match information including lineups, officials, ball possession, and full score details for a specific match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | Yes | The competition ID (e.g. '17'). |
| `match_id` | string | Yes | The match ID (e.g. '400128082'). |
| `season_id` | string | Yes | The season ID (e.g. '255711'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fifa-com-api-a8eb982e/get_match_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competition_id":"<string>","match_id":"<string>","season_id":"<string>"}'
```

### get_match_timeline

Retrieve a timeline of events for a match including goals, cards, fouls, substitutions, coin toss, and other in-game events with minute markers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | The match ID (e.g. '400128082'). |

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

### get_mens_world_ranking

Retrieve the full FIFA Men's World Ranking. Returns teams ranked by FIFA points in descending order. Each team includes rank, points, movement since last ranking, confederation, and country code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of teams to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fifa-com-api-a8eb982e/get_mens_world_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_news_article

Retrieve full article content by entry ID. Returns structured rich text body, hero image, title, and publication date. Use entryId values from get_news_list results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_id` | string | Yes | The article entry ID from get_news_list items[*].entryId. |

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

### get_news_list

Retrieve latest FIFA news articles from the FIFA+ platform. Returns article summaries with titles, dates, preview text, images, and entry IDs for fetching full content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of articles to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fifa-com-api-a8eb982e/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_player_profile

Retrieve personal profile information for a player including name, birth date, height, weight, nationality, international caps, and goals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | The player ID (e.g. '406304'). |

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

### get_player_stats

Retrieve detailed player statistics for a completed tournament season. Returns stats keyed by player ID, with arrays of stat name/value tuples covering goals, assists, passes, crosses, cards, and physical data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season_id` | string | Yes | The season ID of a completed or in-progress tournament (e.g. '255711' for FIFA World Cup 2022). |

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

### get_team_detail

Retrieve detailed information for a specific team including name, abbreviation, country, city, foundation year, and confederation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | The team ID (e.g. '43946' for France). |

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

### get_tournament_overview

Retrieve overview information for a specific tournament/competition including its name, gender classification, and competition type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | Yes | The competition/tournament ID (e.g. '17' for FIFA World Cup). |

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

### get_tournament_scores_fixtures

Retrieve match fixtures and results for a tournament season. Returns all matches with home/away teams, scores, dates, stadiums, and match status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season_id` | string | Yes | The season ID (e.g. '255711' for FIFA World Cup 2022, '285023' for FIFA World Cup 2026). |

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

### get_tournament_seasons

Retrieve all seasons/editions for a specific tournament. Returns season IDs, abbreviations, start/end dates for each edition.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | Yes | The competition/tournament ID (e.g. '17' for FIFA World Cup). |

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

### get_tournament_standings

Retrieve tournament group standings for a specific stage. Returns standings for all groups with position, points, won, lost, drawn, goals for/against.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | Yes | The competition ID (e.g. '17' for FIFA World Cup). |
| `season_id` | string | Yes | The season ID (e.g. '255711'). |
| `stage_id` | string | Yes | The stage ID (e.g. '289273' for group stage of FIFA World Cup 2026). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fifa-com-api-a8eb982e/get_tournament_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competition_id":"<string>","season_id":"<string>","stage_id":"<string>"}'
```

### get_tournament_teams

Retrieve participating teams for a tournament season. Returns team details including name, abbreviation, country, and foundation year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season_id` | string | Yes | The season ID (e.g. '255711' for FIFA World Cup 2022). |

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

### get_tournaments_list

Retrieve a list of FIFA competitions/tournaments available on the platform. Returns competition IDs and names for use with other tournament endpoints.

**Estimated cost:** Metered

_No parameters required._

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

### get_womens_world_ranking

Retrieve the full FIFA Women's World Ranking. Returns teams ranked by FIFA points in descending order. Each team includes rank, points, movement since last ranking, confederation, and country code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of teams to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fifa-com-api-a8eb982e/get_womens_world_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### search

Search FIFA content by keyword. Returns articles, videos, and documents matching the query with relevance scoring. Results include title, URL, image, description, and content type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase. |

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