matchroompool.com APImatchroompool.com ↗
Access WNT player rankings, event schedules, player profiles, and news articles from matchroompool.com via a structured REST API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b990a4e1-f728-47b8-b542-b84049d151c0/get_schedule' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full list of events (upcoming and past) from the schedule page. Returns all events with title, date, location, and URL.
No input parameters required.
{
"type": "object",
"fields": {
"count": "integer total number of events",
"events": "array of event objects with title, date, location, and url"
},
"sample": {
"data": {
"count": 33,
"events": [
{
"url": "https://matchroompool.com/events/scottish-open/",
"date": "May 20 - 23 2026",
"title": "Jacoby Scottish Open",
"location": "Glasgow, Scotland"
},
{
"url": "https://matchroompool.com/events/2026-uk-open-pool-championship/",
"date": "May 26 - 31 2026",
"title": "2026 UK Open Pool Championship",
"location": "Brentwood, Essex, UK"
}
]
},
"status": "success"
}
}About the matchroompool.com API
The Matchroom Pool API exposes 7 endpoints covering the full World Nineball Tour data surface: event schedules, individual event details, player rankings, player profiles, and news articles. The get_rankings endpoint returns each player's rank, name, country, and total prize money, while get_event_details surfaces broadcast status and participating player lists for a given event slug. This is the structured data layer for matchroompool.com without any manual parsing.
Event Schedule and Details
The get_schedule endpoint returns every event on the Matchroom Pool calendar — upcoming and past — with title, date, location, and url for each entry, plus a total count. To drill into a specific tournament, pass its slug to get_event_details (e.g., premier-league-pool or 2026-uk-open-pool-championship). That endpoint returns the event title, description, broadcast_on_wnt_tv boolean, and a participating_players array. Note that some events use image-based banners; in those cases the date and location fields will be null rather than structured strings.
Player Rankings and Profiles
get_rankings returns the full WNT rankings list with rank, name, country, and total_prize_money per player. get_players_list returns the same population with the addition of a profile_url for each player. To retrieve career detail on a specific competitor, call get_player_profile with a slug like fedor-gorst or carlo-biado. The response includes a bio string, current rank, and a stats object containing fields such as alias, hometown, age, height, highest_rank, majors_won, and prize_money.
News Coverage
get_latest_news returns the current article feed with title, date, url, and thumbnail for each item. To retrieve the body of a specific piece, pass the full article URL to get_news_article, which returns the title, publication date, and full content string. This covers Matchroom Pool editorial content including tournament previews, ranking structure announcements, and match recaps.
- Build a live WNT standings tracker using
get_rankingsprize money and country fields - Power a tournament calendar widget with event titles, dates, and locations from
get_schedule - Display player cards with career stats (majors won, highest rank, prize money) pulled from
get_player_profile - Filter upcoming broadcasts by checking
broadcast_on_wnt_tvinget_event_detailsresponses - Aggregate pool news headlines and thumbnails for a sports news aggregator via
get_latest_news - Check which players are registered for a specific event using
participating_playersinget_event_details - Archive full article text for content analysis using
get_news_articleon individual article URLs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Matchroom Pool have an official developer API?+
What does `get_event_details` return when an event uses an image-based banner?+
get_event_details returns null for both date and location. The title is always present via a fallback to page metadata. The description, broadcast_on_wnt_tv, and participating_players fields are still populated where the page exposes them.Does the API return live match scores or in-progress frame counts?+
Are historical rankings or prize money snapshots available?+
get_rankings returns the current WNT standings only; there is no endpoint for point-in-time or season-by-season ranking history. You can fork this API on Parse and revise it to add a historical rankings endpoint if the source publishes that data.How complete is the `stats` object returned by `get_player_profile`?+
stats object is keyed directly to the fields each player's profile page exposes. Common fields include alias, country, hometown, age, height, highest_rank, majors_won, and prize_money, but not every field is populated for every player — the object will only contain keys that appear on that specific profile page.