The Hendon Mob APIthehendonmob.com ↗
Access The Hendon Mob poker database via API. Search players, retrieve tournament results, earnings stats, rankings, trending players, and poker news.
What is the The Hendon Mob API?
This API exposes 4 endpoints covering The Hendon Mob's poker player database, returning player profiles, tournament histories, earnings statistics, and news articles. Use get_player_profile to retrieve a player's total live earnings, All Time Money List rank, best live cash, and up to 20 recent tournament results. search_players lets you look up any player by name and get back their internal player ID for deeper queries.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/edaaa365-de40-407d-9316-1877f148863e/get_trending_players' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace thehendonmob-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.the_hendon_mob_api import HendonMob, Player, PlayerSummary, TrendingPlayer, NewsArticle
client = HendonMob()
# Get trending players and inspect the top one
for player in client.trendingplayers.list():
print(player.name, player.rank, player.player_id)
# Search for a specific player
for result in client.players.search(query="Phil Ivey"):
print(result.name, result.player_id, result.profile_url)
# Drill into full profile
profile = result.details()
print(profile.name, profile.statistics, profile.player_id)
for tr in profile.tournament_results:
print(tr.date, tr.event, tr.place, tr.prize)
break
# Get a player profile directly by ID
player = client.players.get(player_id="181")
print(player.name, player.player_id)
# Browse recent news
for article in client.newsarticles.list():
print(article.title, article.url, article.author, article.date)
Get currently trending players from the homepage. Returns a ranked list of players currently trending on The Hendon Mob. Each player includes their rank, name, ID, and profile URL. The list typically contains 6-10 players and updates frequently based on recent tournament activity.
No input parameters required.
{
"type": "object",
"fields": {
"trending_players": "array of player summary objects with name, player_id, rank, and profile_url"
},
"sample": {
"data": {
"trending_players": [
{
"name": "Kristen Foxen",
"rank": 1,
"player_id": "133320",
"profile_url": "https://pokerdb.thehendonmob.com/player.php?a=r&n=133320"
},
{
"name": "Galen Hall",
"rank": 2,
"player_id": "129276",
"profile_url": "https://pokerdb.thehendonmob.com/player.php?a=r&n=129276"
}
]
},
"status": "success"
}
}About the The Hendon Mob API
Player Search and Profiles
The search_players endpoint accepts a query string (e.g. 'Phil Ivey') and returns an array of matching players, each with a name, player_id, and profile_url. The player_id is a numeric string used as the required input for get_player_profile. The profile endpoint returns a statistics object that includes fields like Total Live Earnings, Best Live Cash, and All Time Money List position, alongside a tournament_results array of the player's 20 most recent cashes, each with date, event, place, and prize.
Trending Players and News
get_trending_players requires no parameters and returns a ranked list of players currently featured on The Hendon Mob homepage, with each entry including name, player_id, rank, and profile_url. This is useful for tracking which players are generating the most attention at any given time. get_poker_news similarly requires no inputs and returns recent articles from the news section, with each article object carrying title, url, author, date, and summary.
Data Scope and Freshness
The tournament_results array is capped at the 20 most recent results per player — full historical tournament records beyond that window are not returned in a single call. Player IDs are stable numeric strings consistent across search_players and get_trending_players, so they can be stored and reused. News articles reflect what appears on The Hendon Mob's news page at query time.
The The Hendon Mob API is a managed, monitored endpoint for thehendonmob.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when 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 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 poker player comparison tool using earnings and ranking fields from
get_player_profile - Track which players are trending in the poker community using
get_trending_playersrank data - Populate a player leaderboard with All Time Money List positions and Total Live Earnings
- Monitor a specific player's recent tournament performance using the
tournament_resultsarray - Aggregate poker news headlines and summaries for a poker-focused content feed via
get_poker_news - Resolve player names to internal IDs using
search_playersbefore fetching full profile data - Alert users when a player they follow appears in the trending players list
| 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 | 100 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 The Hendon Mob have an official developer API?+
How many tournament results does `get_player_profile` return, and can I paginate for older results?+
Does the API return player social media profiles, photos, or nationality data?+
What does the `statistics` object in `get_player_profile` actually contain?+
statistics object includes named key-value pairs drawn from the player's profile stats section, such as Total Live Earnings, Best Live Cash, and All Time Money List position. The exact keys present depend on what The Hendon Mob displays for that player.Can I retrieve results for a specific tournament or filter news articles by category?+
get_player_profile and unfiltered news via get_poker_news. Tournament-specific lookups and news filtering by category are not supported. You can fork the API on Parse and revise it to add a tournament search endpoint.