# Matchroom Pool — 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.

> Access professional pool event schedules, player profiles, rankings, and real-time match updates from Matchroom Pool. Retrieve news articles and detailed tournament information across World Nineball Tour events.

**Category:** Sports | **Website:** [matchroompool.com/](https://matchroompool.com/) | **Docs:** [parse.bot/marketplace/bfd3aa77-2f73-4419-a37f-9375fa2f41ad/matchroompool-com-api](https://parse.bot/marketplace/bfd3aa77-2f73-4419-a37f-9375fa2f41ad/matchroompool-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-matchroompool-com-api-bfd3aa77/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_event_details

Retrieve detailed information about a specific event using its slug. Returns title, description, broadcast status, and participating players when available. Some events use image-based banners without structured date/location fields, in which case those fields will be null. The participating_players array is populated only for invitation-style events with a confirmed player list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Event slug from the event URL path, e.g. 'premier-league-pool' or 'mosconi-cup' |

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

### get_latest_news

Retrieve the latest news articles from Matchroom Pool. Returns article titles, dates, URLs, and thumbnail images. Some entries may be YouTube video embeds with null URLs and dates.

**Estimated cost:** Metered

_No parameters required._

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

### get_news_article

Retrieve the full content of a news article using its URL. Returns the article title, publication date, and full text content. The content field contains the complete article body as plain text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the news article from matchroompool.com |

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

### get_player_profile

Retrieve detailed profile information for a specific player using their slug. Returns biographical information, current rank, and career statistics including alias, country, hometown, age, height, highest rank, majors won, and prize money.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Player slug from the player URL path, e.g. 'fedor-gorst', 'francisco-sanchez-ruiz', 'carlo-biado' |

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

### get_players_list

Retrieve the list of all players on the World Nineball Tour with their rank, country, slug, and profile URL. Players without a current ranking have null rank values.

**Estimated cost:** Metered

_No parameters required._

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

### get_rankings

Retrieve the World Nineball Tour player rankings. Returns ranked players with name, rank number, country, and total prize money. Rankings are ordered by rank ascending.

**Estimated cost:** Metered

_No parameters required._

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

### get_schedule

Retrieve the full list of events from the World Nineball Tour schedule page. Returns all upcoming and past events with title, date, location, slug, and URL. Events are ordered chronologically. The response includes a count field for the total number of events returned.

**Estimated cost:** Metered

_No parameters required._

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