sumodb.sumogames.de APIsumodb.sumogames.de ↗
Access sumo wrestler profiles, banzuke rankings, kimarite technique stats, and yusho winners from the Sumo Reference Database via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/289c1828-b0d6-4d26-af45-202ba31ac1d7/search_rikishi?name=Hakuho' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for sumo wrestlers by name (shikona). Returns a list of matching rikishi with their IDs and profile URLs.
| Param | Type | Description |
|---|---|---|
| namerequired | string | Shikona (ring name) of the wrestler to search for. |
{
"type": "object",
"fields": {
"results": "array of matching rikishi objects with id, shikona, and details_url"
},
"sample": {
"data": {
"results": [
{
"id": "1123",
"shikona": "Hakuho",
"details_url": "https://sumodb.sumogames.de/Rikishi.aspx?r=1123"
}
]
},
"status": "success"
}
}About the sumodb.sumogames.de API
This API exposes 5 endpoints covering the Sumo Reference Database at sumodb.sumogames.de, returning structured data on wrestler profiles, tournament rankings, winning techniques, and historical yusho results. The get_rikishi_profile endpoint alone surfaces over 10 fields per wrestler — including stable affiliation, height, weight, birthplace, and career-high rank — while get_banzuke delivers the full official ranking sheet for any historical or current basho.
Wrestler Search and Profiles
Use search_rikishi to find wrestlers by shikona (ring name). It returns an array of matches, each with a numeric id, the wrestler's shikona, and a details_url. Pass that id to get_rikishi_profile to retrieve the full profile: heya (stable), shusshin (birthplace), height_cm, weight_kg, birth_date, hatsu_dohyo (debut tournament in YYYY.MM format), real_name, and highest_rank with the date it was achieved.
Kimarite Technique Breakdown
get_rikishi_kimarite_stats accepts a rikishi id and returns two arrays — wins_by_kimarite and losses_by_kimarite — each listing technique names alongside occurrence counts. This makes it straightforward to calculate a wrestler's most-used finishing moves or identify techniques they struggle to defend against across their recorded career.
Banzuke Rankings and Tournament History
get_banzuke retrieves the official ranking sheet for any basho. The basho parameter accepts YYYY.MM or YYYYMM format (e.g., 2024.01). Each entry in the rikishi array includes id, shikona, height_cm, weight_kg, title_raw, and optionally rank. The database covers historical tournaments, so you can query banzuke from decades past. get_yusho_winners requires no inputs and returns every tournament winner in reverse chronological order, with basho, makuuchi_winner (rank and name string), and makuuchi_winner_id for cross-referencing with profile endpoints.
- Build a wrestler comparison tool using height, weight, and career-high rank from
get_rikishi_profile - Analyze kimarite trends across eras by pairing
get_yusho_winnersresults with per-wrestler technique stats - Generate historical banzuke visualizations for any tournament using
get_banzukewith a past basho date - Track a rikishi's most frequently used winning techniques using
wins_by_kimaritecounts fromget_rikishi_kimarite_stats - Look up debut dates and stable affiliations for roster management or fantasy sumo applications
- Cross-reference yusho champion IDs with full profiles to build a historical champions database
| 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 sumodb.sumogames.de have an official developer API?+
What does `get_banzuke` return, and can I filter by division?+
id, shikona, title_raw, height_cm, weight_kg, and optionally rank. The current endpoint does not expose a division filter parameter — it returns all wrestlers on the sheet. You can fork it on Parse and revise to add a division filter if you only need Makuuchi or Juryo entries.Does the API include match-by-match results or day-by-day scores for a basho?+
How far back does the yusho winners data go?+
get_yusho_winners returns all winners on record in the database, ordered from most recent to oldest, with no pagination parameter — the full list is returned in a single response.Can I retrieve a rikishi's career record totals (total wins, losses, absences) from the profile endpoint?+
get_rikishi_profile endpoint focuses on biographical and physical attributes — heya, height_cm, weight_kg, birth_date, hatsu_dohyo, and highest_rank. Aggregated career win/loss totals are not currently returned as discrete fields. You can fork it on Parse and revise to add those aggregated career record fields to the profile response.