Thehendonmob APIpokerdb.thehendonmob.com ↗
Access poker players, venues, events, festivals, rankings, and results from the Hendon Mob Poker Database via 16 structured JSON endpoints.
What is the Thehendonmob API?
This API exposes 16 endpoints covering the Hendon Mob Poker Database — one of the most complete records of live tournament poker. You can retrieve player profiles with career earnings and rankings via get_player, pull festival schedules with event-by-event results via get_festival_schedule, list venues with contact details, browse ranked money lists, and page through hundreds of thousands of tournament results — all as structured JSON.
curl -X GET 'https://api.parse.bot/scraper/13129c67-aaf3-4389-839f-8b8c3237d2f5/list_venues?page=1&starting_letter=A' \ -H 'X-API-Key: $PARSE_API_KEY'
List poker venues from the Hendon Mob database. Returns 20 venues per page sorted alphabetically. Supports filtering by starting letter and by region or country code. Pagination is controlled by the page parameter; has_next_page indicates whether more results exist.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (20 venues per page). |
| region | string | Filter by region ID or 3-letter country code. Region IDs: 1=The Americas, 2=Europe, 3=Oceania, 4=Rest of the World, 8=United Kingdom, 9=All-Ireland, 11=Scandinavia, 12=GB and Ireland, 13=Eastern Europe, 14=Africa, 15=Asia, 17=Latin America. Country codes examples: USA, CAN, GBR, FRA, GER, AUS, BRA, JPN. Omitting returns venues worldwide. |
| starting_letter | string | Filter venues by starting letter. Accepts A-Z or # for non-alpha. Omitting returns all venues. |
{
"type": "object",
"fields": {
"page": "current page number",
"venues": "array of venue objects with venue_id, name, country, location, and url_path",
"has_next_page": "whether additional pages of results exist"
},
"sample": {
"data": {
"page": 1,
"venues": [
{
"name": "\"CUBE\" Mall",
"country": "Ukraine",
"location": "Kharkiv",
"url_path": "/venues/cube-mall-1967",
"venue_id": "1967"
},
{
"name": "101 Poker Club Richmond (Formerly Johnny Chan's 88 Social)",
"country": "United States",
"location": "Houston, TX",
"url_path": "/venues/101-poker-club-richmond-formerly-johnny-chan-s-88-social-2915",
"venue_id": "2915"
}
],
"has_next_page": true
},
"status": "success"
}
}About the Thehendonmob API
Players and Rankings
The list_players endpoint returns 100 players per page, filterable by starting_letter and by region (region ID or 3-letter country code). Each record includes player_id, player_name, and country. Passing that player_id to get_player yields a full profile: total_cashes, best_live_cash, born, residence, nationality, and up to 50 recent tournament results with event_name, place, prize, and event_id. For deeper analysis, get_player_rankings returns the player's position across all ranking lists — yearly money lists, all-time lists, circuit-specific lists, and WSOP standings — without the 50-result cap on get_player.
Venues and Festivals
list_venues pages through venues alphabetically (20 per page) and accepts starting_letter and region filters. Each venue object returns a venue_id, name, country, location, and url_path slug. Pass that slug to get_venue for address, telephone, email, and website fields, or to list_venue_recurring_festivals for a venue's full history of recurring festivals split into running_count, upcoming_count, and past_count. Festival details — including each scheduled event's date, event_name, winner, and notes — come from get_festival_schedule using the festival_id from either list_events or list_venue_recurring_festivals.
Events and Results
list_events returns tournaments scheduled within a given week, identified by a date parameter in ISO format. The next_week_date field in the response drives week-by-week pagination. Filtering by region and expanding scope with the weeks parameter (1–10) narrows or broadens the result set. get_event returns full results for a single tournament: entries, prize_pool, and a results array with each finisher's place, player_name, optional player_id, prize, and prize_usd.
Rankings and Database Stats
list_rankings returns all ranking categories with their top 5 players, and accepts optional filters for year, venue, circuit, and country. Circuit codes (e.g. WSOP, WPT, 888) come from list_circuits. get_ranking paginates the full ranked list at 100 players per page, returning each player's rank, value, and player_id. get_database_stats returns the three headline counts — total players, events, and results — directly from the database homepage.
The Thehendonmob API is a managed, monitored endpoint for pokerdb.thehendonmob.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pokerdb.thehendonmob.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official pokerdb.thehendonmob.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a player career tracker showing total cashes, best live cash, and recent results by player ID
- Aggregate venue contact info (address, phone, website) for a regional poker room directory
- Monitor upcoming festival schedules week-by-week using list_events with next_week_date pagination
- Construct yearly money-list leaderboards by filtering list_rankings by year and circuit code
- Track a venue's complete tournament history using list_venue_recurring_festivals with running, upcoming, and past counts
- Compare player rankings across WSOP, WPT, and circuit-specific lists via get_player_rankings
- Display prize pool breakdowns and full finishing orders for specific events using get_event results
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.