Sumo API
App · Sports · 14 actions
Look up professional sumo with Sumo API: search wrestlers and read their profiles and career records, get every bout they have fought and their record against any opponent, pull a tournament's championship and prize winners, a division's banzuke and any day's torikumi, and browse the winning techniques bouts are decided by. Uses the keyless public API. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Get a day's bouts (torikumi) | Get the torikumi (every bout in one division on one day of a tournament) with both wrestlers, their ranks, the winner and the technique it was won by. |
| Get a division's rankings (banzuke) | Get the banzuke (the official ranking sheet) for one division at one tournament, with each wrestler's rank, side and win/loss record. |
| Get a head-to-head record | Get the record between two wrestlers: how many bouts each has won, the techniques they won them by, and every bout they have fought. |
| Get a tournament | Get one tournament: when and where it was held, who won each division's championship (yusho) and who took the special prizes (sansho). |
| Get a wrestler | Get one wrestler's profile: ring name, stable, rank, height, weight, where they are from and when they debuted, optionally with how their measurements, ranks and ring names have changed over their career. |
| Get a wrestler's bouts | Get every bout a wrestler has fought, most recent tournament first, with the opponent, the rank each held and the technique the bout was won by. |
| Get a wrestler's career record | Get a wrestler's career totals: tournaments fought, bouts won and lost, absences, championships (yusho) and special prizes (sansho), broken down by division. |
| Get bouts won by a technique | Get the bouts a given winning technique decided: every yorikiri, or every rare technique you want examples of. |
| Get head-to-head records in bulk | Get several head-to-head records in one request: one entry per pair of wrestlers, each returned under a label you choose. |
| Get measurement changes | Get recorded changes in height and weight, either one wrestler's over their career, or everyone's at one tournament. |
| Get rank changes | Get recorded rank changes, either one wrestler's climb and fall down the banzuke, or every rank recorded at one tournament. |
| Get ring-name changes | Get recorded shikona (ring name) changes, either every name one wrestler has competed under, or every name change recorded at one tournament. |
| List winning techniques | List the kimarite (the winning techniques a bout can be decided by), with how many recorded bouts each has decided and when it was last used. |
| Search wrestlers | Find sumo wrestlers by ring name, stable or database id, and get the wrestler id every other action takes. |
Get a day's bouts (torikumi)
Get the torikumi (every bout in one division on one day of a tournament) with both wrestlers, their ranks, the winner and the technique it was won by. No API key required.
Inputs
- Tournament
basho_idtextRequired - The tournament, as a year and month run together: 202303 is the March 2023 tournament. '2023-03' and a full date such as '2023-03-12' also work. Grand tournaments are held in January, March, May, July, September and November.
- Division
divisiontextRequired - Which division to read, from Makuuchi at the top of the banzuke down to Jonokuchi at the bottom.One of:
Makuuchi(Makuuchi (top division)),Juryo(Juryo (second division, salaried)),Makushita(Makushita (third division)),Sandanme(Sandanme (fourth division)),Jonidan(Jonidan (fifth division)),Jonokuchi(Jonokuchi (entry division)). Default:Makuuchi. - Day
daynumberRequired - Which day of the tournament, 1 to 15. When a tournament ends level, the playoff bouts are recorded past day 15.From 1 to 20. Default:
1.
Outputs
basho_idtext- The same id, under a stable key.
basho_monthnumber- The month it was held, 1-12.
basho_month_nametext- That month's English name.
basho_nametext- The tournament's name, from the month it is held in (Hatsu, Haru, Natsu, Nagoya, Aki or Kyushu).
basho_yearnumber- The year it was held.
countnumber- How many bouts were fought.
datetext- The tournament id, as YYYYMM.
daynumber- The day they were fought.
divisiontext- The division these bouts are from.
endDatetext- When it finished.
locationtext- Where it was held.
matcheslist- The same bouts, under the name other actions use.
special_prizeslist- The special prizes awarded (Shukun-sho, Kanto-sho, Gino-sho).
startDatetext- When it started.
torikumilist- The day's bouts, in the order they were fought.
yusholist- The championship winner of each division.
Example output
{
"basho_id": "202303",
"basho_month": 3,
"basho_month_name": "March",
"basho_name": "Haru Basho",
"basho_year": 2023,
"count": 1,
"date": "202303",
"day": 14,
"division": "Makuuchi",
"endDate": "2023-03-26T00:00:00Z",
"location": "Osaka",
"matches": [
{
"bashoId": "202303",
"day": 14,
"division": "Makuuchi",
"eastId": 45,
"eastRank": "Yokozuna 1 East",
"eastShikona": "Terunofuji",
"east_won": true,
"kimarite": "yorikiri",
"loser_id": 12,
"loser_shikona": "Takakeisho",
"matchNo": 20,
"westId": 12,
"westRank": "Ozeki 1 West",
"westShikona": "Takakeisho",
"winnerEn": "Terunofuji",
"winnerId": 45,
"winner_shikona": "Terunofuji"
}
],
"special_prizes": [
{
"rikishiId": 12,
"shikonaEn": "Kiribayama",
"shikonaJp": "\u9727\u99ac\u5c71",
"type": "Shukun-sho"
}
],
"startDate": "2023-03-12T00:00:00Z",
"torikumi": [
{
"bashoId": "202303",
"day": 14,
"division": "Makuuchi",
"eastId": 45,
"eastRank": "Yokozuna 1 East",
"eastShikona": "Terunofuji",
"east_won": true,
"kimarite": "yorikiri",
"loser_id": 12,
"loser_shikona": "Takakeisho",
"matchNo": 20,
"westId": 12,
"westRank": "Ozeki 1 West",
"westShikona": "Takakeisho",
"winnerEn": "Terunofuji",
"winnerId": 45,
"winner_shikona": "Terunofuji"
}
],
"yusho": [
{
"rikishiId": 12,
"shikonaEn": "Kiribayama",
"shikonaJp": "\u9727\u99ac\u5c71",
"type": "Makuuchi"
}
]
}Get a division's rankings (banzuke)
Get the banzuke (the official ranking sheet) for one division at one tournament, with each wrestler's rank, side and win/loss record. East and west come back separately, as the sheet is drawn, plus one combined list in ranking order. No API key required.
Inputs
- Tournament
basho_idtextRequired - The tournament, as a year and month run together: 202303 is the March 2023 tournament. '2023-03' and a full date such as '2023-03-12' also work. Grand tournaments are held in January, March, May, July, September and November.
- Division
divisiontextRequired - Which division to read, from Makuuchi at the top of the banzuke down to Jonokuchi at the bottom.One of:
Makuuchi(Makuuchi (top division)),Juryo(Juryo (second division, salaried)),Makushita(Makushita (third division)),Sandanme(Sandanme (fourth division)),Jonidan(Jonidan (fifth division)),Jonokuchi(Jonokuchi (entry division)). Default:Makuuchi.
Outputs
basho_idtext- The tournament this banzuke is for.
countnumber- How many wrestlers are on the banzuke.
divisiontext- The division this banzuke is for.
eastlist- The east side of the sheet.
westlist- The west side of the sheet.
wrestlerslist- Everyone on the banzuke, highest rank first, east and west combined.
Example output
{
"basho_id": "202303",
"count": 1,
"division": "Makuuchi",
"east": [
{
"absences": 0,
"losses": 4,
"rank": "Yokozuna 1 East",
"rankValue": 101,
"record": [],
"rikishiID": 45,
"rikishi_id": 45,
"shikonaEn": "Terunofuji",
"side": "East",
"wins": 11
}
],
"west": [],
"wrestlers": [
{
"absences": 0,
"losses": 4,
"rank": "Yokozuna 1 East",
"rankValue": 101,
"record": [],
"rikishiID": 45,
"rikishi_id": 45,
"shikonaEn": "Terunofuji",
"side": "East",
"wins": 11
}
]
}Get a head-to-head record
Get the record between two wrestlers: how many bouts each has won, the techniques they won them by, and every bout they have fought. No API key required.
Inputs
- Wrestler ID
rikishi_idnumberRequired - The wrestler's Sumo API id, as returned by 'Search wrestlers'. This is the API's own id, not a SumoDB or NSK number.At least 1.
- Opponent ID
opponent_idnumberRequired - The other wrestler's Sumo API id.At least 1.
- Tournament
basho_idtext - Optional. Narrow the results to one tournament, as a year and month run together: 202303 is the March 2023 tournament. Leave empty for every tournament.
Outputs
basho_idtext- The tournament the bouts were filtered to, if any.
countnumber- How many bouts this response holds.
kimariteLossesobject- The techniques the first wrestler's losses came by, counted.
kimariteWinsobject- The techniques the first wrestler's wins came by, counted.
losses_in_resultnumber- Bouts in this response the first wrestler lost.
matcheslist- Every bout the two have fought.
opponent_idnumber- The second wrestler's id.
opponent_winsnumber- Bouts won by the second wrestler.
rikishi_idnumber- The first wrestler's id.
rikishi_winsnumber- Bouts won by the first wrestler.
totalnumber- How many bouts they have fought in total.
wins_in_resultnumber- Bouts in this response the first wrestler won, the same as the total unless a tournament filter was used.
Example output
{
"basho_id": null,
"count": 1,
"kimariteLosses": {
"hatakikomi": 5,
"tsukiotoshi": 5
},
"kimariteWins": {
"oshidashi": 6,
"yorikiri": 8
},
"losses_in_result": 0,
"matches": [
{
"bashoId": "202303",
"day": 14,
"division": "Makuuchi",
"eastId": 45,
"eastRank": "Yokozuna 1 East",
"eastShikona": "Terunofuji",
"east_won": true,
"kimarite": "yorikiri",
"loser_id": 12,
"loser_shikona": "Takakeisho",
"matchNo": 20,
"westId": 12,
"westRank": "Ozeki 1 West",
"westShikona": "Takakeisho",
"winnerEn": "Terunofuji",
"winnerId": 45,
"winner_shikona": "Terunofuji"
}
],
"opponent_id": 12,
"opponent_wins": 10,
"rikishi_id": 45,
"rikishi_wins": 14,
"total": 24,
"wins_in_result": 1
}Get a tournament
Get one tournament: when and where it was held, who won each division's championship (yusho) and who took the special prizes (sansho). No API key required.
Inputs
- Tournament
basho_idtextRequired - The tournament, as a year and month run together: 202303 is the March 2023 tournament. '2023-03' and a full date such as '2023-03-12' also work. Grand tournaments are held in January, March, May, July, September and November.
Outputs
basho_idtext- The same id, under a stable key.
basho_monthnumber- The month it was held, 1-12.
basho_month_nametext- That month's English name.
basho_nametext- The tournament's name, from the month it is held in (Hatsu, Haru, Natsu, Nagoya, Aki or Kyushu).
basho_yearnumber- The year it was held.
datetext- The tournament id, as YYYYMM.
endDatetext- When it finished.
locationtext- Where it was held.
special_prizeslist- The special prizes awarded (Shukun-sho, Kanto-sho, Gino-sho).
startDatetext- When it started.
yusholist- The championship winner of each division.
Example output
{
"basho_id": "202303",
"basho_month": 3,
"basho_month_name": "March",
"basho_name": "Haru Basho",
"basho_year": 2023,
"date": "202303",
"endDate": "2023-03-26T00:00:00Z",
"location": "Osaka",
"special_prizes": [
{
"rikishiId": 12,
"shikonaEn": "Kiribayama",
"shikonaJp": "\u9727\u99ac\u5c71",
"type": "Shukun-sho"
}
],
"startDate": "2023-03-12T00:00:00Z",
"yusho": [
{
"rikishiId": 12,
"shikonaEn": "Kiribayama",
"shikonaJp": "\u9727\u99ac\u5c71",
"type": "Makuuchi"
}
]
}Get a wrestler
Get one wrestler's profile: ring name, stable, rank, height, weight, where they are from and when they debuted, optionally with how their measurements, ranks and ring names have changed over their career. No API key required.
Inputs
- Wrestler ID
rikishi_idnumberRequired - The wrestler's Sumo API id, as returned by 'Search wrestlers'. This is the API's own id, not a SumoDB or NSK number.At least 1.
- Include measurement history
include_measurementstrue/false - Include how the wrestler's height and weight have changed over their career.Default:
false. - Include rank history
include_rankstrue/false - Include the wrestler's rank at every tournament they appeared in.Default:
false. - Include ring-name history
include_shikonastrue/false - Include every shikona (ring name) the wrestler has competed under.Default:
false. - History order
sort_ordertext - Order of the measurement, rank and shikona history included above, by tournament. Has no effect unless one of those is switched on.One of:
desc(Descending: most recent first),asc(Ascending: oldest first). Default:desc.
Outputs
birthDatetext- Date of birth.
currentRanktext- Their rank on the current banzuke, e.g. 'Yokozuna 1 East'.
debuttext- The tournament they debuted at, as YYYYMM.
heightnumber- Height in centimetres.
heyatext- The stable they belong to.
idnumber- The wrestler's Sumo API id, which every other action takes.
intaitext- Retirement date. Absent while they are still competing.
is_activetrue/false- True when no retirement date is recorded.
nskIdnumber- The wrestler's official id with the Japan Sumo Association (NSK).
shikonaEntext- The wrestler's ring name in the Latin alphabet.
shikonaJptext- The same ring name in Japanese.
shusshintext- Where they are from.
sumodbIdnumber- The wrestler's id in the SumoDB database, when known.
weightnumber- Weight in kilograms.
Example output
{
"birthDate": "1991-11-29T00:00:00Z",
"currentRank": "Yokozuna 1 East",
"debut": "201101",
"height": 192,
"heya": "Isegahama",
"id": 45,
"intai": null,
"is_active": true,
"nskId": 3321,
"shikonaEn": "Terunofuji Haruo",
"shikonaJp": "\u7167\u30ce\u5bcc\u58eb \u6625\u96c4",
"shusshin": "Mongolia, Ulaanbaatar",
"sumodbId": 11927,
"weight": 184
}Get a wrestler's bouts
Get every bout a wrestler has fought, most recent tournament first, with the opponent, the rank each held and the technique the bout was won by. Narrow it to a single tournament to get one basho's results. No API key required.
Inputs
- Wrestler ID
rikishi_idnumberRequired - The wrestler's Sumo API id, as returned by 'Search wrestlers'. This is the API's own id, not a SumoDB or NSK number.At least 1.
- Tournament
basho_idtext - Optional. Narrow the results to one tournament, as a year and month run together: 202303 is the March 2023 tournament. Leave empty for every tournament.
Outputs
basho_idtext- The tournament these results were filtered to, if any.
countnumber- How many results this response holds.
has_moretrue/false- True when further results are waiting past this page.
limitnumber- The page size that was used.
matcheslist- The bouts, most recent first.
rikishi_idnumber- The wrestler these results were filtered to, if any.
skipnumber- How many results were skipped before this page.
totalnumber- How many results match in total, across all pages.
Example output
{
"basho_id": "202303",
"count": 1,
"has_more": false,
"limit": null,
"matches": [
{
"bashoId": "202303",
"day": 14,
"division": "Makuuchi",
"eastId": 45,
"eastRank": "Yokozuna 1 East",
"eastShikona": "Terunofuji",
"east_won": true,
"kimarite": "yorikiri",
"loser_id": 12,
"loser_shikona": "Takakeisho",
"matchNo": 20,
"westId": 12,
"westRank": "Ozeki 1 West",
"westShikona": "Takakeisho",
"winnerEn": "Terunofuji",
"winnerId": 45,
"winner_shikona": "Terunofuji"
}
],
"rikishi_id": 45,
"skip": 0,
"total": 1
}Get a wrestler's career record
Get a wrestler's career totals: tournaments fought, bouts won and lost, absences, championships (yusho) and special prizes (sansho), broken down by division. No API key required.
Inputs
- Wrestler ID
rikishi_idnumberRequired - The wrestler's Sumo API id, as returned by 'Search wrestlers'. This is the API's own id, not a SumoDB or NSK number.At least 1.
Outputs
absenceByDivisionobject- Absences, counted per division.
bashonumber- How many tournaments they have fought in.
bashoByDivisionobject- Tournaments fought, counted per division.
lossByDivisionobject- Bouts lost, counted per division.
rikishi_idnumber- The wrestler these totals are for.
sanshoobject- Special prizes won, counted by prize (Shukun-sho, Kanto-sho, Gino-sho).
totalAbsencesnumber- Bouts missed through absence.
totalByDivisionobject- Bouts fought, counted per division.
totalLossesnumber- Bouts lost.
totalMatchesnumber- Bouts fought across their career.
totalWinsnumber- Bouts won.
winsByDivisionobject- Bouts won, counted per division.
yushonumber- Tournament championships won.
yushoByDivisionobject- Those championships, counted per division.
Example output
{
"absenceByDivision": {
"Juryo": 0,
"Makuuchi": 20
},
"basho": 62,
"bashoByDivision": {
"Juryo": 8,
"Makuuchi": 45
},
"lossByDivision": {
"Juryo": 30,
"Makuuchi": 180
},
"rikishi_id": 45,
"sansho": {
"Gino-sho": 2,
"Kanto-sho": 3,
"Shukun-sho": 4
},
"totalAbsences": 21,
"totalByDivision": {
"Juryo": 90,
"Makuuchi": 540
},
"totalLosses": 244,
"totalMatches": 712,
"totalWins": 447,
"winsByDivision": {
"Juryo": 60,
"Makuuchi": 340
},
"yusho": 9,
"yushoByDivision": {
"Juryo": 1,
"Makuuchi": 8
}
}Get bouts won by a technique
Get the bouts a given winning technique decided: every yorikiri, or every rare technique you want examples of. No API key required.
Inputs
- Technique
kimaritetextRequired - The winning technique to look up, e.g. 'yorikiri' (force out) or 'uwatenage' (overarm throw).
- Order
sort_ordertext - Order the bouts by tournament, oldest or newest first.One of:
desc(Descending: most recent first),asc(Ascending: oldest first). Default:asc. - Maximum results
limitnumber - How many bouts to return. The API allows at most 1000 per request; use 'Skip' to page through more.From 1 to 1000. Default:
20. - Skip
skipnumber - How many results to skip before returning any: page two of a 20-result page starts at 20.At least 0.
Outputs
countnumber- How many results this response holds.
has_moretrue/false- True when further results are waiting past this page.
kimaritetext- The technique these bouts were won by.
limitnumber- The page size that was used.
matcheslist- The bouts this technique decided.
skipnumber- How many results were skipped before this page.
totalnumber- How many results match in total, across all pages.
Example output
{
"count": 1,
"has_more": true,
"kimarite": "yorikiri",
"limit": 20,
"matches": [
{
"bashoId": "202303",
"day": 14,
"division": "Makuuchi",
"eastId": 45,
"eastRank": "Yokozuna 1 East",
"eastShikona": "Terunofuji",
"east_won": true,
"kimarite": "yorikiri",
"loser_id": 12,
"loser_shikona": "Takakeisho",
"matchNo": 20,
"westId": 12,
"westRank": "Ozeki 1 West",
"westShikona": "Takakeisho",
"winnerEn": "Terunofuji",
"winnerId": 45,
"winner_shikona": "Terunofuji"
}
],
"skip": 0,
"total": 234567
}Get head-to-head records in bulk
Get several head-to-head records in one request: one entry per pair of wrestlers, each returned under a label you choose. Use this instead of a step per pairing when comparing a whole field. No API key required.
Inputs
- Pairings
matchupslistRequired - The pairs of wrestlers to compare. Each entry is either an object like {"key": "terunofuji-vs-takakeisho", "ids": [45, 12]} or just the two ids, as [45, 12] or "45-12". Without a key, a pairing is labelled '<first>-<second>'.
- Maximum results
limitnumber - How many bouts per pairing to return. The API allows at most 1000 per request; use 'Skip' to page through more.From 1 to 1000.
- Skip
skipnumber - How many bouts to skip in each pairing before returning any.At least 0.
- Order
sort_ordertext - Order the bouts in each pairing by tournament, newest or oldest first.One of:
desc(Descending: most recent first),asc(Ascending: oldest first).
Outputs
countnumber- How many pairings came back.
keyslist- The labels the records are keyed by.
matchupslist- The pairings exactly as they were requested.
resultsobject- One head-to-head record per pairing, keyed by the pairing's label.
Example output
{
"count": 1,
"keys": [
"45-12"
],
"matchups": [
{
"ids": [
45,
12
],
"key": "45-12"
}
],
"results": {
"45-12": {
"count": 1,
"matches": [
{
"bashoId": "202303",
"day": 14,
"division": "Makuuchi",
"eastId": 45,
"eastRank": "Yokozuna 1 East",
"eastShikona": "Terunofuji",
"east_won": true,
"kimarite": "yorikiri",
"loser_id": 12,
"loser_shikona": "Takakeisho",
"matchNo": 20,
"westId": 12,
"westRank": "Ozeki 1 West",
"westShikona": "Takakeisho",
"winnerEn": "Terunofuji",
"winnerId": 45,
"winner_shikona": "Terunofuji"
}
],
"opponent_id": 12,
"opponent_wins": 10,
"rikishi_id": 45,
"rikishi_wins": 14,
"total": 24
}
}
}Get measurement changes
Get recorded changes in height and weight, either one wrestler's over their career, or everyone's at one tournament. No API key required.
Inputs
- Wrestler ID
rikishi_idnumber - The wrestler whose changes to return. Give this or a tournament, not both.At least 1.
- Tournament
basho_idtext - The tournament whose changes to return, as a year and month run together (202301). Give this or a wrestler, not both.
- Order
sort_ordertext - Order the results by tournament, newest or oldest first.One of:
desc(Descending: most recent first),asc(Ascending: oldest first). Default:desc. - Maximum results
limitnumber - How many records to return. The API allows at most 1000 per request; use 'Skip' to page through more.From 1 to 1000.
- Skip
skipnumber - How many results to skip before returning any: page two of a 20-result page starts at 20.At least 0.
Outputs
basho_idtext- The tournament these results were filtered to, if any.
countnumber- How many results this response holds.
has_moretrue/false- True when further results are waiting past this page.
limitnumber- The page size that was used.
measurementslist- The measurement records, by tournament.
rikishi_idnumber- The wrestler these results were filtered to, if any.
skipnumber- How many results were skipped before this page.
totalnumber- How many results match in total, across all pages.
Example output
{
"basho_id": null,
"count": 1,
"has_more": false,
"limit": null,
"measurements": [
{
"bashoId": "202303",
"height": 192,
"id": "202303-45",
"rikishiId": 45,
"weight": 184
}
],
"rikishi_id": 45,
"skip": 0,
"total": 1
}Get rank changes
Get recorded rank changes, either one wrestler's climb and fall down the banzuke, or every rank recorded at one tournament. No API key required.
Inputs
- Wrestler ID
rikishi_idnumber - The wrestler whose changes to return. Give this or a tournament, not both.At least 1.
- Tournament
basho_idtext - The tournament whose changes to return, as a year and month run together (202301). Give this or a wrestler, not both.
- Order
sort_ordertext - Order the results by tournament, newest or oldest first.One of:
desc(Descending: most recent first),asc(Ascending: oldest first). Default:desc. - Maximum results
limitnumber - How many records to return. The API allows at most 1000 per request; use 'Skip' to page through more.From 1 to 1000.
- Skip
skipnumber - How many results to skip before returning any: page two of a 20-result page starts at 20.At least 0.
Outputs
basho_idtext- The tournament these results were filtered to, if any.
countnumber- How many results this response holds.
has_moretrue/false- True when further results are waiting past this page.
limitnumber- The page size that was used.
rankslist- The rank records, by tournament.
rikishi_idnumber- The wrestler these results were filtered to, if any.
skipnumber- How many results were skipped before this page.
totalnumber- How many results match in total, across all pages.
Example output
{
"basho_id": null,
"count": 1,
"has_more": false,
"limit": null,
"ranks": [
{
"bashoId": "202303",
"id": "202303-45",
"rank": "Yokozuna 1 East",
"rankValue": 101,
"rikishiId": 45
}
],
"rikishi_id": 45,
"skip": 0,
"total": 1
}Get ring-name changes
Get recorded shikona (ring name) changes, either every name one wrestler has competed under, or every name change recorded at one tournament. No API key required.
Inputs
- Wrestler ID
rikishi_idnumber - The wrestler whose changes to return. Give this or a tournament, not both.At least 1.
- Tournament
basho_idtext - The tournament whose changes to return, as a year and month run together (202301). Give this or a wrestler, not both.
- Order
sort_ordertext - Order the results by tournament, newest or oldest first.One of:
desc(Descending: most recent first),asc(Ascending: oldest first). Default:desc. - Maximum results
limitnumber - How many records to return. The API allows at most 1000 per request; use 'Skip' to page through more.From 1 to 1000.
- Skip
skipnumber - How many results to skip before returning any: page two of a 20-result page starts at 20.At least 0.
Outputs
basho_idtext- The tournament these results were filtered to, if any.
countnumber- How many results this response holds.
has_moretrue/false- True when further results are waiting past this page.
limitnumber- The page size that was used.
rikishi_idnumber- The wrestler these results were filtered to, if any.
shikonaslist- The ring-name records, by tournament.
skipnumber- How many results were skipped before this page.
totalnumber- How many results match in total, across all pages.
Example output
{
"basho_id": null,
"count": 1,
"has_more": false,
"limit": null,
"rikishi_id": 45,
"shikonas": [
{
"bashoId": "202303",
"id": "202303-45",
"rikishiId": 45,
"shikonaEn": "Terunofuji Haruo",
"shikonaJp": "\u7167\u30ce\u5bcc\u58eb \u6625\u96c4"
}
],
"skip": 0,
"total": 1
}List winning techniques
List the kimarite (the winning techniques a bout can be decided by), with how many recorded bouts each has decided and when it was last used. No API key required.
Inputs
- Sort by
sort_fieldtext - Which column to order the techniques by.One of:
count(How often the technique has been used),kimarite(Technique name (alphabetical)),lastUsage(When the technique was last used). Default:count. - Order
sort_ordertext - Whether to sort ascending or descending.One of:
desc(Descending: most recent first),asc(Ascending: oldest first). Default:asc. - Maximum results
limitnumber - How many techniques to return. The API allows at most 1000 per request; use 'Skip' to page through more.From 1 to 1000.
- Skip
skipnumber - How many results to skip before returning any: page two of a 20-result page starts at 20.At least 0.
Outputs
countnumber- How many results this response holds.
has_moretrue/false- True when further results are waiting past this page.
kimaritelist- The winning techniques and how often each is used.
limitnumber- The page size that was used.
skipnumber- How many results were skipped before this page.
totalnumber- How many results match in total, across all pages.
Example output
{
"count": 1,
"has_more": true,
"kimarite": [
{
"count": 234567,
"kimarite": "yorikiri",
"lastUsage": "202305-11",
"last_basho_id": "202305",
"last_day": 11
}
],
"limit": 1,
"skip": 0,
"total": 82
}Search wrestlers
Find sumo wrestlers by ring name, stable or database id, and get the wrestler id every other action takes. Searches currently active wrestlers unless retired ones are included. No API key required.
Inputs
- Ring name
shikona_entext - Search by shikona (ring name) in the Latin alphabet, e.g. 'Terunofuji'.
- Stable
heyatext - Only include wrestlers from this heya (stable), by its full English name.
- SumoDB ID
sumodb_idnumber - Find the wrestler with this id in the SumoDB database, e.g. 11927 for Terunofuji.At least 1.
- NSK ID
nsk_idnumber - Find the wrestler with this official Japan Sumo Association id, e.g. 3321 for Terunofuji.At least 1.
- Include retired wrestlers
include_retiredtrue/false - Search retired wrestlers as well as active ones. Off by default, which is why a search for a past champion can come back empty.Default:
false. - Include measurement history
include_measurementstrue/false - Include how the wrestler's height and weight have changed over their career.Default:
false. - Include rank history
include_rankstrue/false - Include the wrestler's rank at every tournament they appeared in.Default:
false. - Include ring-name history
include_shikonastrue/false - Include every shikona (ring name) the wrestler has competed under.Default:
false. - History order
sort_ordertext - Order of the measurement, rank and shikona history included above, by tournament. Has no effect unless one of those is switched on.One of:
desc(Descending: most recent first),asc(Ascending: oldest first). Default:desc. - Maximum results
limitnumber - How many wrestlers to return. The API allows at most 1000 per request; use 'Skip' to page through more.From 1 to 1000. Default:
20. - Skip
skipnumber - How many results to skip before returning any: page two of a 20-result page starts at 20.At least 0.
Outputs
countnumber- How many results this response holds.
has_moretrue/false- True when further results are waiting past this page.
limitnumber- The page size that was used.
rikishilist- The wrestlers that matched.
skipnumber- How many results were skipped before this page.
totalnumber- How many results match in total, across all pages.
Example output
{
"count": 1,
"has_more": false,
"limit": 20,
"rikishi": [
{
"birthDate": "1991-11-29T00:00:00Z",
"currentRank": "Yokozuna 1 East",
"debut": "201101",
"height": 192,
"heya": "Isegahama",
"id": 45,
"intai": null,
"is_active": true,
"nskId": 3321,
"shikonaEn": "Terunofuji Haruo",
"shikonaJp": "\u7167\u30ce\u5bcc\u58eb \u6625\u96c4",
"shusshin": "Mongolia, Ulaanbaatar",
"sumodbId": 11927,
"weight": 184
}
],
"skip": 0,
"total": 1
}