Gatari API Documentation
Documentation to retrieve scores and users from osu!gatari.
Allowed HTTPs requests:
GET : Get a resource or list of resources
Description Of Usual Server Responses
Nearly every method returns a JSON object with code field having one of the following values:
-
200
OK- the request was successful. -
204
No Content- the request was successful but there is no representation to return (i.e. the response is empty). -
400
Bad Request- the request could not be understood or was missing required parameters. -
403
Forbidden- access denied. -
404
Not Found- resource was not found.
Common notation:
-
Game modes
- 0 standard
- 1 taiko
- 2 catch the beat
- 3 mania
-
Mods are explained at https://github.com/ppy/osu-api/wiki#mods
-
Pages start from 1
-
Completed
- 3 means highest pp score
- 4 means highest score by score, but not highest by pp
- 2 means neither highest by pp nor score
-
ranked
- 0 not ranked
- 1 recently updated (not used in public API)
- 2 ranked
- 3 approved (old term for ranked)
- 4 quailified
- 5 loved
-
Naturally you won’t be able to retrieve information about restricted, banned users or users with closed profile through public API except for user’s score on a beatmap.
-
Date format is universal sortable datetime format …
-
Where time is involved, it is epoch number https://en.wikipedia.org/wiki/Unix_time
-
ranked_status_frozen- 0 means the map is ranked on the official server and gatari
- 1 means the map is ranked only on gatari
Resource Group ¶
User's info ¶
Get user’s general info. If user doesn’t exist or is restricted or hidden, the stats field will be empty array.
Instead of u you can use several numeric parameters ids to get an array with many users’ info.
Example: /users/get?ids=1000&ids=1015
Retrieve user infoGET/users/get{?u}
Example URI
GET https://api.gatari.pw/users/get?u=Xxdstem
URI Parameters
- u
Number or String(required) Example: XxdstemEither numeric
idof the User or theirusername. If the user’s name is only digits, it is recommended to use numeric id
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"users": [
{
"abbr": null,
"clanid": null,
"country": "RU",
"favourite_mode": 0,
"followers_count": 394,
"id": 1000,
"latest_activity": 1567635311,
"play_style": 6,
"privileges": 7340031,
"registered_on": 1484068800,
"username": "Xxdstem",
"username_aka": ""
}
]
}User's stats ¶
Get user’s stats. If user doesn’t exist or is restricted or hidden, the stats field will be empty object.
Retrieve user statsGET/user/stats{?u,mode}
Example URI
GET https://api.gatari.pw/user/stats?u=Xxdstem&mode=0
URI Parameters
- u
Number or String(required) Example: XxdstemEither numeric
idof the User or theirusername. If the user’s name is only digits, it is recommended to use numeric id- mode
Number(optional) Example: 0Game mode to retrieve stats from. Defaults to std
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"stats": {
"a_count": 918,
"avg_accuracy": 98.082702636719,
"avg_hits_play": 176.4,
"country_rank": 17,
"id": 1000,
"level": 100,
"level_progress": 58,
"max_combo": 4151,
"playcount": 84468,
"playtime": 5123159,
"pp": 7988,
"rank": 92,
"ranked_score": 14500166427,
"replays_watched": 509,
"s_count": 359,
"sh_count": 42,
"total_hits": 12321797,
"total_score": 84490780780,
"x_count": 23,
"xh_count": 7
}
}User's recent scores ¶
Get user’s recent scores
Retrieve user's recent scoresGET/user/scores/recent{?id,l,p,mode,f,ppFilter}
Example URI
GET https://api.gatari.pw/user/scores/recent?id=1000&l=20&p=1&mode=0&f=0&ppFilter=0
URI Parameters
- id
Number(required) Example: 1000Numeric
idof the user- mode
Number(required) Example: 0Game mode
- p
Number(optional) Example: 1Page number
- l
Number(optional)Page length. Maximum is 100
- f
Boolean(0,1)(optional) Example: 0Include failed plays
- ppFilter
Number(optional) Example: 0Only return plays with more than {ppFilter} pp
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"count": 0,
"scores": [
{
"accuracy": 95.341613769531,
"beatmap": {
"ar": 10,
"beatmap_id": 281631,
"beatmap_md5": "d7776438f6d90fa8879129996c06c36e",
"beatmapset_id": 107475,
"bpm": 200,
"creator": "7odoa",
"difficulty": 6.70917,
"fc": 1946,
"hit_length": 220,
"od": 8,
"ranked": 5,
"ranked_status_frozen": 0,
"song_name": "OSTER project - Capriccio of My Mind [Extra AR10]"
},
"completed": 3,
"count_100": 73,
"count_300": 1509,
"count_50": 10,
"count_gekis": 188,
"count_katu": 32,
"count_miss": 18,
"full_combo": false,
"id": 35380315,
"isfav": false,
"max_combo": 941,
"mods": 0,
"play_mode": 0,
"pp": 0,
"ranking": "A",
"score": 20712988,
"time": "2019-08-27T12:56:49+02:00",
"views": 0
}
]
}User's best scores ¶
Get user’s best scores by pp.
Retrieve user's best scoresGET/user/scores/best{?id,l,p,mode,mods}
Example URI
GET https://api.gatari.pw/user/scores/best?id=1000&l=20&p=1&mode=0&mods=0
URI Parameters
- id
Number(required) Example: 1000Numeric
idof the user- mode
Number(required) Example: 0Game mode
- p
Number(required) Example: 1Page number
- l
Number(required) Example: 20Page length. Maximum is 100
- mods
Number(optional) Example: 0Only show plays with {mods} included
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"count": 0,
"scores": [
{
"accuracy": 99.190696716309,
"beatmap": {
"ar": 9.1,
"beatmap_id": 1954587,
"beatmap_md5": "4debb8d5552dd7548d30702aaa75626d",
"beatmapset_id": 935541,
"bpm": 153,
"creator": "Alumetri",
"difficulty": 4.9831,
"fc": 891,
"hit_length": 176,
"od": 9,
"ranked": 2,
"ranked_status_frozen": 1,
"song_name": "FRENDZONA / MEYBI BEYBI - ASKORBINKA [Cellular Madness]"
},
"completed": 3,
"count_100": 5,
"count_300": 652,
"count_50": 0,
"count_gekis": 158,
"count_katu": 4,
"count_miss": 2,
"full_combo": false,
"id": 35281541,
"isfav": false,
"max_combo": 851,
"mods": 64,
"play_mode": 0,
"pp": 461.06,
"ranking": "A",
"score": 14726069,
"time": "2019-08-25T17:28:59+02:00",
"views": 0
}
]
}User's first places ¶
Get user’s first place on the map scores.
Retrieve user's first placesGET/user/scores/first{?id,mode,p,l}
Example URI
GET https://api.gatari.pw/user/scores/first?id=13191&mode=0&p=1&l=20
URI Parameters
- id
Number(required) Example: 13191Numeric
idof the user- mode
Number(required) Example: 0Game mode
- p
Number(required) Example: 1Page number starting from 1
- l
Number(required) Example: 20Page length. Maximum is 100
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"count": 16,
"scores": [
{
"accuracy": 97.922996520996,
"beatmap": {
"ar": 9.4,
"beatmap_id": 2020137,
"beatmap_md5": "bf5f3c9fed6f669c13e932523481ead1",
"beatmapset_id": 964997,
"bpm": 172,
"creator": "Nanashima Asami",
"difficulty": 5.62444,
"fc": 1520,
"hit_length": 200,
"od": 8.6,
"ranked": 2,
"ranked_status_frozen": 1,
"song_name": "PSYQUI - Still in my heart feat. Punipuni Denki [I'm gonna miss you]"
},
"completed": 3,
"count_100": 15,
"count_300": 961,
"count_50": 3,
"count_gekis": 285,
"count_katu": 11,
"count_miss": 8,
"full_combo": false,
"id": 35441361,
"isfav": false,
"max_combo": 1240,
"mods": 24,
"play_mode": 0,
"pp": 227.04,
"ranking": "A",
"score": 33980738,
"time": "2019-08-28T14:50:06+02:00",
"views": 0
},
{
"accuracy": 96.760124206543,
"beatmap": {
"ar": 10,
"beatmap_id": 1175902,
"beatmap_md5": "0f6beee87efdf178992c20682267766e",
"beatmapset_id": 555610,
"bpm": 190,
"creator": "lahphnya",
"difficulty": 7.48973,
"fc": 2134,
"hit_length": 246,
"od": 8,
"ranked": 5,
"ranked_status_frozen": 2,
"song_name": "BlackY - Max Burning!! (2014 Update XXXtended!!!!) [Arles]"
},
"completed": 3,
"count_100": 39,
"count_300": 1540,
"count_50": 0,
"count_gekis": 189,
"count_katu": 20,
"count_miss": 26,
"full_combo": false,
"id": 35387431,
"isfav": false,
"max_combo": 599,
"mods": 8,
"play_mode": 0,
"pp": 0,
"ranking": "A",
"score": 12054639,
"time": "2019-08-27T15:08:18+02:00",
"views": 0
},
{
"accuracy": 92.642639160156,
"beatmap": {
"ar": 10,
"beatmap_id": 1773683,
"beatmap_md5": "18ec7a7b381180f9143507877d468e05",
"beatmapset_id": 848133,
"bpm": 160,
"creator": "None1637",
"difficulty": 7.27023,
"fc": 1247,
"hit_length": 134,
"od": 10,
"ranked": 5,
"ranked_status_frozen": 2,
"song_name": "Siromaru/Cranky - Conflict [Extra AR10]"
},
"completed": 3,
"count_100": 61,
"count_300": 801,
"count_50": 8,
"count_gekis": 175,
"count_katu": 28,
"count_miss": 18,
"full_combo": false,
"id": 35386469,
"isfav": false,
"max_combo": 372,
"mods": 8,
"play_mode": 0,
"pp": 0,
"ranking": "A",
"score": 4675415,
"time": "2019-08-27T14:51:12+02:00",
"views": 0
},
{
"accuracy": 95.671295166016,
"beatmap": {
"ar": 10,
"beatmap_id": 2059975,
"beatmap_md5": "06216adf8dde67cbfc923974092ee767",
"beatmapset_id": 580821,
"bpm": 199,
"creator": "saggi",
"difficulty": 7.08058,
"fc": 1252,
"hit_length": 184,
"od": 8.5,
"ranked": 5,
"ranked_status_frozen": 0,
"song_name": "Krewella - Say Goodbye (Speed Up Ver.) [ChuuritsuTv's Distortion]"
},
"completed": 3,
"count_100": 34,
"count_300": 677,
"count_50": 3,
"count_gekis": 192,
"count_katu": 31,
"count_miss": 6,
"full_combo": false,
"id": 35385501,
"isfav": false,
"max_combo": 262,
"mods": 8,
"play_mode": 0,
"pp": 0,
"ranking": "A",
"score": 2551375,
"time": "2019-08-27T14:32:34+02:00",
"views": 0
},
{
"accuracy": 96.788581848145,
"beatmap": {
"ar": 9.5,
"beatmap_id": 2040486,
"beatmap_md5": "6cfd9df1601d9ddeed52a19a2e2e5eee",
"beatmapset_id": 974832,
"bpm": 153,
"creator": "Mir",
"difficulty": 6.06029,
"fc": 1846,
"hit_length": 219,
"od": 9,
"ranked": 4,
"ranked_status_frozen": 0,
"song_name": "lapix - Horizon Blue feat. Kanata.N [Endless Expanse]"
},
"completed": 3,
"count_100": 45,
"count_300": 1070,
"count_50": 0,
"count_gekis": 273,
"count_katu": 36,
"count_miss": 6,
"full_combo": false,
"id": 35319447,
"isfav": false,
"max_combo": 754,
"mods": 24,
"play_mode": 0,
"pp": 163.37,
"ranking": "A",
"score": 12378102,
"time": "2019-08-26T11:38:47+02:00",
"views": 0
},
{
"accuracy": 97.525428771973,
"beatmap": {
"ar": 9.4,
"beatmap_id": 1034768,
"beatmap_md5": "7edf63008ba595c09ca9ab90b8b62d71",
"beatmapset_id": 485223,
"bpm": 190,
"creator": "Zectro",
"difficulty": 6.28667,
"fc": 2630,
"hit_length": 299,
"od": 8.7,
"ranked": 2,
"ranked_status_frozen": 1,
"song_name": "USAO - Loss Time [Time Warp]"
},
"completed": 3,
"count_100": 38,
"count_300": 1649,
"count_50": 1,
"count_gekis": 268,
"count_katu": 27,
"count_miss": 16,
"full_combo": false,
"id": 35318861,
"isfav": false,
"max_combo": 488,
"mods": 24,
"play_mode": 0,
"pp": 133.6,
"ranking": "A",
"score": 12341990,
"time": "2019-08-26T11:26:34+02:00",
"views": 0
},
{
"accuracy": 97.413795471191,
"beatmap": {
"ar": 10,
"beatmap_id": 966686,
"beatmap_md5": "fce1539d565f5d5fc9f2bb6a5cbf7992",
"beatmapset_id": 450381,
"bpm": 95,
"creator": "DoKito",
"difficulty": 7.11261,
"fc": 1490,
"hit_length": 193,
"od": 9,
"ranked": 5,
"ranked_status_frozen": 2,
"song_name": "xi - Halcyon [DoKoAR10]"
},
"completed": 3,
"count_100": 19,
"count_300": 1067,
"count_50": 1,
"count_gekis": 306,
"count_katu": 16,
"count_miss": 15,
"full_combo": false,
"id": 35275274,
"isfav": false,
"max_combo": 390,
"mods": 8,
"play_mode": 0,
"pp": 0,
"ranking": "A",
"score": 10832490,
"time": "2019-08-25T15:40:02+02:00",
"views": 0
},
{
"accuracy": 99.44751739502,
"beatmap": {
"ar": 9.5,
"beatmap_id": 1862002,
"beatmap_md5": "3559aa5c39f705438d579c14e3f0d2fe",
"beatmapset_id": 882398,
"bpm": 194,
"creator": "Daisuke",
"difficulty": 6.13539,
"fc": 482,
"hit_length": 78,
"od": 8,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "soraru - Gin no Kisei (TV Size) [Misery]"
},
"completed": 3,
"count_100": 3,
"count_300": 359,
"count_50": 0,
"count_gekis": 93,
"count_katu": 3,
"count_miss": 0,
"full_combo": true,
"id": 35270796,
"isfav": false,
"max_combo": 482,
"mods": 24,
"play_mode": 0,
"pp": 393.38,
"ranking": "SH",
"score": 5168643,
"time": "2019-08-25T14:15:37+02:00",
"views": 0
},
{
"accuracy": 99.846740722656,
"beatmap": {
"ar": 9,
"beatmap_id": 1854467,
"beatmap_md5": "d95abd5c9fc279d91f70a851db4081d3",
"beatmapset_id": 887102,
"bpm": 189,
"creator": "Frey",
"difficulty": 5.73416,
"fc": 643,
"hit_length": 122,
"od": 8,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "Rammstein - Feuer frei! [Fire at will! BANG! BANG!!]"
},
"completed": 3,
"count_100": 1,
"count_300": 434,
"count_50": 0,
"count_gekis": 107,
"count_katu": 1,
"count_miss": 0,
"full_combo": true,
"id": 35270480,
"isfav": false,
"max_combo": 643,
"mods": 24,
"play_mode": 0,
"pp": 344.49,
"ranking": "SH",
"score": 9755405,
"time": "2019-08-25T14:10:14+02:00",
"views": 0
},
{
"accuracy": 99.444442749023,
"beatmap": {
"ar": 10,
"beatmap_id": 692704,
"beatmap_md5": "0d76ca6c9c2266c0dab3f6454f6f1a2a",
"beatmapset_id": 309912,
"bpm": 150,
"creator": "A s h e m u",
"difficulty": 6.10216,
"fc": 1160,
"hit_length": 171,
"od": 9.3,
"ranked": 2,
"ranked_status_frozen": 1,
"song_name": "Hanatan - Paranoia -MMD EXTEND Ver.- [Extra]"
},
"completed": 3,
"count_100": 5,
"count_300": 774,
"count_50": 0,
"count_gekis": 140,
"count_katu": 4,
"count_miss": 1,
"full_combo": false,
"id": 35257623,
"isfav": false,
"max_combo": 1114,
"mods": 8,
"play_mode": 0,
"pp": 323.27,
"ranking": "A",
"score": 26666676,
"time": "2019-08-25T09:09:15+02:00",
"views": 0
},
{
"accuracy": 96.845695495605,
"beatmap": {
"ar": 9,
"beatmap_id": 220231,
"beatmap_md5": "ba0023de53622b2998cfdceaef857ad3",
"beatmapset_id": 72217,
"bpm": 220,
"creator": "Dark Fang",
"difficulty": 5.91333,
"fc": 1335,
"hit_length": 152,
"od": 7,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "Zips - Heisei Cataclysm [0108]"
},
"completed": 3,
"count_100": 37,
"count_300": 745,
"count_50": 0,
"count_gekis": 132,
"count_katu": 15,
"count_miss": 0,
"full_combo": true,
"id": 35206559,
"isfav": false,
"max_combo": 1335,
"mods": 24,
"play_mode": 0,
"pp": 307.9,
"ranking": "SH",
"score": 27674909,
"time": "2019-08-24T11:26:04+02:00",
"views": 0
},
{
"accuracy": 95.173454284668,
"beatmap": {
"ar": 8,
"beatmap_id": 39653,
"beatmap_md5": "b0e3eb9ce09234bbe31168822241a026",
"beatmapset_id": 9978,
"bpm": 160,
"creator": "Armin",
"difficulty": 3.83265,
"fc": 267,
"hit_length": 77,
"od": 8,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "ALI PROJECT - Baragoku Otome (TV Size) [Insane]"
},
"completed": 3,
"count_100": 16,
"count_300": 205,
"count_50": 0,
"count_gekis": 32,
"count_katu": 8,
"count_miss": 0,
"full_combo": false,
"id": 35102537,
"isfav": false,
"max_combo": 263,
"mods": 64,
"play_mode": 0,
"pp": 229.47,
"ranking": "S",
"score": 1527153,
"time": "2019-08-22T14:39:33+02:00",
"views": 0
},
{
"accuracy": 98.019798278809,
"beatmap": {
"ar": 9,
"beatmap_id": 707802,
"beatmap_md5": "55249f92d2445c185303f6416063bd2b",
"beatmapset_id": 317749,
"bpm": 155,
"creator": "Pho",
"difficulty": 5.26025,
"fc": 937,
"hit_length": 134,
"od": 8.5,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "EYE_XY feat. Yoneko - Knight of Firmament [Sanctum]"
},
"completed": 3,
"count_100": 18,
"count_300": 588,
"count_50": 0,
"count_gekis": 122,
"count_katu": 15,
"count_miss": 0,
"full_combo": false,
"id": 35051227,
"isfav": false,
"max_combo": 936,
"mods": 24,
"play_mode": 0,
"pp": 276.68,
"ranking": "SH",
"score": 18266897,
"time": "2019-08-21T16:27:04+02:00",
"views": 0
},
{
"accuracy": 99.601196289062,
"beatmap": {
"ar": 9.2,
"beatmap_id": 1139789,
"beatmap_md5": "f687b4b8ecffcdf78ecb6e5748ded893",
"beatmapset_id": 504171,
"bpm": 174,
"creator": "Nathan",
"difficulty": 5.41777,
"fc": 1422,
"hit_length": 186,
"od": 8.5,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "Yunomi - Wakusei Rabbit (feat. TORIENA) [PYON]"
},
"completed": 3,
"count_100": 6,
"count_300": 997,
"count_50": 0,
"count_gekis": 273,
"count_katu": 6,
"count_miss": 0,
"full_combo": false,
"id": 35050860,
"isfav": false,
"max_combo": 1420,
"mods": 24,
"play_mode": 0,
"pp": 383.92,
"ranking": "SH",
"score": 37974235,
"time": "2019-08-21T16:21:10+02:00",
"views": 0
},
{
"accuracy": 99.339385986328,
"beatmap": {
"ar": 9.3,
"beatmap_id": 1526606,
"beatmap_md5": "5af5b073865eacbaf278c1c9bbeea54c",
"beatmapset_id": 723219,
"bpm": 178,
"creator": "Kalibe",
"difficulty": 5.42578,
"fc": 1792,
"hit_length": 304,
"od": 8.5,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "Chitose Haru (CV: Numakura Manami) - Lucy [Arrival]"
},
"completed": 3,
"count_100": 12,
"count_300": 1199,
"count_50": 0,
"count_gekis": 436,
"count_katu": 10,
"count_miss": 0,
"full_combo": false,
"id": 35050035,
"isfav": false,
"max_combo": 1791,
"mods": 24,
"play_mode": 0,
"pp": 356.07,
"ranking": "SH",
"score": 72951613,
"time": "2019-08-21T16:05:47+02:00",
"views": 0
},
{
"accuracy": 99.845321655273,
"beatmap": {
"ar": 9,
"beatmap_id": 2007268,
"beatmap_md5": "d85a53ed8122b07d13680b149cb27415",
"beatmapset_id": 958711,
"bpm": 180,
"creator": "Mun",
"difficulty": 5.20437,
"fc": 679,
"hit_length": 123,
"od": 9,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "sakuzyo feat. Nikki Simmons - Destr0yer [Afterwar] [Terminus]"
},
"completed": 3,
"count_100": 1,
"count_300": 430,
"count_50": 0,
"count_gekis": 101,
"count_katu": 1,
"count_miss": 0,
"full_combo": false,
"id": 35049716,
"isfav": false,
"max_combo": 678,
"mods": 24,
"play_mode": 0,
"pp": 297.47,
"ranking": "SH",
"score": 10110254,
"time": "2019-08-21T16:00:06+02:00",
"views": 2
}
]
}User's most played maps ¶
Get user’s most played maps.
Retrieve user's most played mapsGET/user/mostplays{?id,mode,page}
Example URI
GET https://api.gatari.pw/user/mostplays?id=1000&mode=0&page=1
URI Parameters
- id
Number(required) Example: 1000Numeric
idof the user- mode
Number(required) Example: 0Game mode
- page
Number(required) Example: 1Page number
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"result": [
{
"beatmap_id": 1268170,
"beatmap_md5": "181f5c1882fbc12602ecb540fa7d89a7",
"beatmapset_id": 600106,
"creator": "Testo",
"difficulty": 6.21313,
"playcount": 608,
"song_name": "Dimrain47 - Infernoplex [Epic]"
},
{
"beatmap_id": 1556336,
"beatmap_md5": "10a2aa425fc1080e31e7ad152541ca2b",
"beatmapset_id": 737128,
"creator": "A r M i N",
"difficulty": 5.4435,
"playcount": 419,
"song_name": "ONE OK ROCK - Bombs away [Sotarks' Detonation]"
},
{
"beatmap_id": 1316758,
"beatmap_md5": "5b2535c79748febc0f470efea1d80c77",
"beatmapset_id": 624763,
"creator": "0109-",
"difficulty": 4.9839,
"playcount": 381,
"song_name": "HoneyWorks meets TrySail - Senpai. [MOVIE Ver.] [Notice me!]"
},
{
"beatmap_id": 574471,
"beatmap_md5": "ca85d0b46ba1e8ddf30af1815cef7b0f",
"beatmapset_id": 249939,
"creator": "No Dap",
"difficulty": 4.97907,
"playcount": 344,
"song_name": "Fujijo Seitokai Shikkou-bu - Best FriendS [Insane]"
},
{
"beatmap_id": 1642274,
"beatmap_md5": "e7533a9b965d5b69b9334896b5807464",
"beatmapset_id": 781509,
"creator": "Sotarks",
"difficulty": 6.36366,
"playcount": 320,
"song_name": "Vickeblanka - Black Rover (TV Size) [Extra]"
},
{
"beatmap_id": 1619564,
"beatmap_md5": "04045f5dd7f1e51f771a3135843f38b2",
"beatmapset_id": 770306,
"creator": "MaridiuS",
"difficulty": 5.25259,
"playcount": 318,
"song_name": "miwa - chAngE [Seni's InsAnE]"
}
]
}User's favourite scores ¶
Get user’s favourite scores showcased in the profile.
Retrieve user's favourite scoresGET/user/scores/favs{?id,mode,p,l}
Example URI
GET https://api.gatari.pw/user/scores/favs?id=1000&mode=0&p=1&l=20
URI Parameters
- id
Number(required) Example: 1000Numeric
idof the User- mode
Number(required) Example: 0Game mode
- p
Number(required) Example: 1Page number
- l
Number(required) Example: 20Page length. Maximum is 100
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"count": 0,
"scores": [
{
"accuracy": 95.678436279297,
"beatmap": {
"ar": 9.5,
"beatmap_id": 1256809,
"beatmap_md5": "cc4cbed3121f14b7d59ccc3d8164ae71",
"beatmapset_id": 594170,
"bpm": 190,
"creator": "Drummer",
"difficulty": 6.12744,
"fc": 4295,
"hit_length": 639,
"od": 8.8,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "Avenged Sevenfold - Save Me [Tragedy]"
},
"completed": 2,
"count_100": 202,
"count_300": 2995,
"count_50": 2,
"count_gekis": 460,
"count_katu": 137,
"count_miss": 2,
"full_combo": false,
"id": 15767838,
"isfav": true,
"max_combo": 879,
"mods": 16,
"play_mode": 0,
"pp": 151.24,
"ranking": "A",
"score": 51541182,
"time": "2018-07-04T06:33:45+02:00",
"views": 0
},
{
"accuracy": 98.056365966797,
"beatmap": {
"ar": 9.3,
"beatmap_id": 1023307,
"beatmap_md5": "def405114e483c0e09099f6cf6b68a40",
"beatmapset_id": 295946,
"bpm": 100,
"creator": "Kencho",
"difficulty": 5.49452,
"fc": 514,
"hit_length": 86,
"od": 8.5,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "Mikuni Shimokawa - Sore ga, Ai deshou [Extra]"
},
"completed": 3,
"count_100": 7,
"count_300": 334,
"count_50": 0,
"count_gekis": 66,
"count_katu": 6,
"count_miss": 2,
"full_combo": false,
"id": 26300786,
"isfav": true,
"max_combo": 361,
"mods": 64,
"play_mode": 0,
"pp": 344.62,
"ranking": "A",
"score": 3188961,
"time": "2019-02-18T14:26:11+02:00",
"views": 0
},
{
"accuracy": 97.16088104248,
"beatmap": {
"ar": 9.3,
"beatmap_id": 1854204,
"beatmap_md5": "1d6cbb05fc7fb1baad1f63a2e803e0c1",
"beatmapset_id": 876133,
"bpm": 202,
"creator": "Xandit",
"difficulty": 5.40096,
"fc": 499,
"hit_length": 84,
"od": 8,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "UNLIMITS - Haruka Kanata (TV Size) [Nevo's Expert]"
},
"completed": 3,
"count_100": 12,
"count_300": 304,
"count_50": 0,
"count_gekis": 66,
"count_katu": 7,
"count_miss": 1,
"full_combo": false,
"id": 26331931,
"isfav": true,
"max_combo": 393,
"mods": 64,
"play_mode": 0,
"pp": 341.52,
"ranking": "A",
"score": 2850598,
"time": "2019-02-19T04:51:38+02:00",
"views": 0
},
{
"accuracy": 92.904289245605,
"beatmap": {
"ar": 9.2,
"beatmap_id": 1911308,
"beatmap_md5": "78d30593b190800323a799ab24c4a49c",
"beatmapset_id": 906786,
"bpm": 183,
"creator": "Sotarks",
"difficulty": 6.26584,
"fc": 549,
"hit_length": 87,
"od": 9.4,
"ranked": 2,
"ranked_status_frozen": 0,
"song_name": "Koda Kumi - Guess Who Is Back (TV Size) [Fiery's Extreme]"
},
"completed": 3,
"count_100": 19,
"count_300": 275,
"count_50": 1,
"count_gekis": 83,
"count_katu": 15,
"count_miss": 8,
"full_combo": false,
"id": 27435864,
"isfav": true,
"max_combo": 408,
"mods": 64,
"play_mode": 0,
"pp": 378.58,
"ranking": "A",
"score": 3117442,
"time": "2019-03-10T20:53:14+02:00",
"views": 0
}
]
}User's achievements ¶
Get user’s achievements showcased in the profile. Includes both official server achievements and gatari-specific ones.
enable stands for “acquired”, API only returns 1.
- Achievement categories:
- 0 Skill
- 1 Dedication
- 2 Mods
- 3 Secret
Retrieve user's achievementsGET/user/achievements{?u,mode}
Example URI
GET https://api.gatari.pw/user/achievements?u=Xxdstem&mode=0
URI Parameters
- u
Number or String(required) Example: XxdstemEither numeric
idof the User or theirusername. If the user’s name is only digits, it is recommended to use numeric id- mode
Number(required) Example: 0Game mode
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"data": {
"0": {
"achievements": [
{
"category": 0,
"color": "brown",
"description": "Your dedication has paid off. Welcome to the top 1,000!",
"enable": 1,
"icon": "all-skill-highranker-1",
"name": "I can see the top",
"time": 1548103319
},
{
"category": 0,
"color": "gray",
"description": "There's no stopping you, is there? Welcome to the top 500!",
"enable": 1,
"icon": "all-skill-highranker-2",
"name": "The gradual rise",
"time": 1548103319
},
{
"category": 0,
"color": "yellow",
"description": " Welcome to the top 250. Never give up!",
"enable": 1,
"icon": "all-skill-highranker-3",
"name": "Scaling up",
"time": 1548103319
},
{
"category": 0,
"color": "blue",
"description": "Pro tier. Welcome to the top 100!",
"enable": 1,
"icon": "all-skill-highranker-4",
"name": "Top player",
"time": 1548103319
}
],
"name": "Skill"
},
"1": {
"achievements": [],
"name": "Dedication"
},
"2": {
"achievements": [
{
"category": 2,
"color": "pink",
"description": "You can't stop the rock.",
"enable": 1,
"icon": "all-intro-hardrock",
"name": "Rock Around The Clock",
"time": 1548103319
},
{
"category": 2,
"color": "pink",
"description": "Having a right ol' time. One and a half of them, almost.",
"enable": 1,
"icon": "all-intro-doubletime",
"name": "Time And A Half",
"time": 1548103319
},
{
"category": 2,
"color": "pink",
"description": "Founded in the fine tradition of changing things that were just fine as they were.",
"enable": 1,
"icon": "all-intro-nightcore",
"name": "Sweet Rave Party",
"time": 1548103319
},
{
"category": 2,
"color": "pink",
"description": "I can see just perfectly.",
"enable": 1,
"icon": "all-intro-hidden",
"name": "Blindsight",
"time": 1548103319
},
{
"category": 2,
"color": "pink",
"description": "Harder than it looks, probably because it's hard to look.",
"enable": 1,
"icon": "all-intro-flashlight",
"name": "Are You Afraid Of The Dark?",
"time": 1562008358
},
{
"category": 2,
"color": "pink",
"description": "Sometimes you just want to take it easy.",
"enable": 1,
"icon": "all-intro-easy",
"name": "Dial It Right Back",
"time": 1548103319
},
{
"category": 2,
"color": "pink",
"description": "Safety nets are fun!",
"enable": 1,
"icon": "all-intro-nofail",
"name": "Risk Averse",
"time": 1548103319
},
{
"category": 2,
"color": "pink",
"description": "You got there. Eventually.",
"enable": 1,
"icon": "all-intro-halftime",
"name": "Slowboat",
"time": 1559657270
}
],
"name": "Mod Introduction"
},
"3": {
"achievements": [
{
"category": 3,
"color": "purple",
"description": "Accuracy is really underrated.",
"enable": 1,
"icon": "all-secret-rank-s",
"name": "S-Ranker",
"time": 1549479968
},
{
"category": 3,
"color": "purple",
"description": "Endure.",
"enable": 1,
"icon": "all-secret-perseverance",
"name": "Perseverance",
"time": 1548103319
},
{
"category": 3,
"color": "purple",
"description": "Places to be, things to do.",
"enable": 1,
"icon": "all-secret-ntts",
"name": "No Time To Spare",
"time": 1549204605
},
{
"category": 3,
"color": "purple",
"description": "That wasn't easy at all!",
"enable": 1,
"icon": "osu-secret-deception",
"name": "Behold No Deception",
"time": 1548510838
},
{
"category": 3,
"color": "purple",
"description": "Begin the Gatari Renaissance.",
"enable": 1,
"icon": "all-secret-qatar",
"name": "Re:Gatari",
"time": 1549472609
}
],
"name": "Hush-Hush"
}
}
}User's favourite maps ¶
Get user’s favourite maps as seen the in beatmaps tab of the user profile.
Retrieve user's favourite mapsGET/user/favs{?id,p}
Example URI
GET https://api.gatari.pw/user/favs?id=1000&p=1
URI Parameters
- id
Number(required) Example: 1000Numeric
idof the User- p
Number(required) Example: 1Page number
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"result": [
{
"artist": "DragonForce",
"beatmaps": [
{
"beatmap_id": 1001682,
"difficulty_ctb": 4.40305,
"difficulty_mania": 3.82816,
"difficulty_std": 6.09769,
"difficulty_taiko": 5.38866,
"mode": 0,
"version": "Myth"
}
],
"beatmapset_id": 382400,
"creator": "Ponoyoshi",
"favourite_count": 5,
"passcount": 2110,
"playcount": 30289,
"ranked": 2,
"ranked_status_freezed": 0,
"ranking_data": 1486006727,
"title": "Through the Fire and Flames"
},
{
"artist": "Camellia",
"beatmaps": [
{
"beatmap_id": 1057141,
"difficulty_ctb": 6.17443,
"difficulty_mania": 3.63918,
"difficulty_std": 6.52639,
"difficulty_taiko": 7.48432,
"mode": 0,
"version": "Schizophrenia"
},
{
"beatmap_id": 1193177,
"difficulty_ctb": 6.17443,
"difficulty_mania": 3.67019,
"difficulty_std": 6.52639,
"difficulty_taiko": 7.48432,
"mode": 0,
"version": "Schizophrenia 9.8"
}
],
"beatmapset_id": 496656,
"creator": "Mazzerin",
"favourite_count": 3,
"passcount": 36,
"playcount": 865,
"ranked": 5,
"ranked_status_freezed": 2,
"ranking_data": 1518887018,
"title": "Introduction / NEURO-CLOUD-9"
},
{
"artist": "Kanpyohgo",
"beatmaps": [
{
"beatmap_id": 1094653,
"difficulty_ctb": 0.989112,
"difficulty_mania": 1.11341,
"difficulty_std": 1.64009,
"difficulty_taiko": 2.23585,
"mode": 0,
"version": "Easy"
},
{
"beatmap_id": 1184897,
"difficulty_ctb": 1.24991,
"difficulty_mania": 1.96327,
"difficulty_std": 2.03057,
"difficulty_taiko": 2.36122,
"mode": 0,
"version": "Azucat's Normal"
},
{
"beatmap_id": 1154745,
"difficulty_ctb": 2.01053,
"difficulty_mania": 2.29174,
"difficulty_std": 3.24659,
"difficulty_taiko": 4.43323,
"mode": 0,
"version": "Dailycare's Hard"
},
{
"beatmap_id": 1125982,
"difficulty_ctb": 2.52939,
"difficulty_mania": 2.65873,
"difficulty_std": 3.88087,
"difficulty_taiko": 4.51042,
"mode": 0,
"version": "N a s y a's Insane"
},
{
"beatmap_id": 1096903,
"difficulty_ctb": 2.45733,
"difficulty_mania": 3.06086,
"difficulty_std": 4.82775,
"difficulty_taiko": 4.90301,
"mode": 0,
"version": "Satellite's Lunatic"
},
{
"beatmap_id": 1093661,
"difficulty_ctb": 4.08671,
"difficulty_mania": 3.13108,
"difficulty_std": 5.46493,
"difficulty_taiko": 5.70142,
"mode": 0,
"version": "Extra"
},
{
"beatmap_id": 1093704,
"difficulty_ctb": 5.12007,
"difficulty_mania": 3.06143,
"difficulty_std": 5.97812,
"difficulty_taiko": 5.52913,
"mode": 0,
"version": "yf's Expert"
},
{
"beatmap_id": 1093703,
"difficulty_ctb": 5.28159,
"difficulty_mania": 2.79977,
"difficulty_std": 6.67522,
"difficulty_taiko": 5.47524,
"mode": 0,
"version": "FreeSongs' Rolling Hell"
}
],
"beatmapset_id": 514980,
"creator": "My Angel Azusa",
"favourite_count": 1,
"passcount": 283,
"playcount": 2901,
"ranked": 2,
"ranked_status_freezed": 0,
"ranking_data": 1489695681,
"title": "Unmei no Dark Side -Rolling Gothic mix"
},
{
"artist": "Avenged Sevenfold",
"beatmaps": [
{
"beatmap_id": 1256809,
"difficulty_ctb": 4.37164,
"difficulty_mania": 2.94093,
"difficulty_std": 6.12744,
"difficulty_taiko": 5.01052,
"mode": 0,
"version": "Tragedy"
}
],
"beatmapset_id": 594170,
"creator": "Drummer",
"favourite_count": 12,
"passcount": 787,
"playcount": 16397,
"ranked": 2,
"ranked_status_freezed": 0,
"ranking_data": 1500726029,
"title": "Save Me"
},
{
"artist": "Helblinde",
"beatmaps": [
{
"beatmap_id": 1257904,
"difficulty_ctb": 0,
"difficulty_mania": 0,
"difficulty_std": 6.55556,
"difficulty_taiko": 6.29517,
"mode": 0,
"version": "Aspire"
}
],
"beatmapset_id": 594751,
"creator": "ProfessionalBox",
"favourite_count": 3,
"passcount": 134,
"playcount": 1779,
"ranked": 2,
"ranked_status_freezed": 0,
"ranking_data": 1491342195,
"title": "The Solace of Oblivion"
},
{
"artist": "RADWIMPS",
"beatmaps": [
{
"beatmap_id": 1286617,
"difficulty_ctb": 1.94134,
"difficulty_mania": 2.03564,
"difficulty_std": 0,
"difficulty_taiko": 3.29769,
"mode": 0,
"version": "Irohas' Hard"
},
{
"beatmap_id": 1262436,
"difficulty_ctb": 0.9962,
"difficulty_mania": 1.19801,
"difficulty_std": 1.75993,
"difficulty_taiko": 1.65318,
"mode": 0,
"version": "Toukai's Easy"
},
{
"beatmap_id": 1286618,
"difficulty_ctb": 1.24398,
"difficulty_mania": 1.88065,
"difficulty_std": 2.10837,
"difficulty_taiko": 2.36919,
"mode": 0,
"version": "Dunois' Normal"
},
{
"beatmap_id": 1272266,
"difficulty_ctb": 2.42616,
"difficulty_mania": 2.32679,
"difficulty_std": 4.0587,
"difficulty_taiko": 3.65414,
"mode": 0,
"version": "Walao's Light Insane"
},
{
"beatmap_id": 1269573,
"difficulty_ctb": 2.91957,
"difficulty_mania": 2.49636,
"difficulty_std": 4.41251,
"difficulty_taiko": 3.84412,
"mode": 0,
"version": "NiNo's Insane"
},
{
"beatmap_id": 1271851,
"difficulty_ctb": 2.79252,
"difficulty_mania": 2.49798,
"difficulty_std": 4.63657,
"difficulty_taiko": 4.04285,
"mode": 0,
"version": "Sotarks' Insane"
},
{
"beatmap_id": 1262435,
"difficulty_ctb": 2.71417,
"difficulty_mania": 2.78099,
"difficulty_std": 4.6808,
"difficulty_taiko": 3.73885,
"mode": 0,
"version": "NeoSL's Insane"
},
{
"beatmap_id": 1276291,
"difficulty_ctb": 3.07864,
"difficulty_mania": 2.56176,
"difficulty_std": 4.86725,
"difficulty_taiko": 3.81196,
"mode": 0,
"version": "Insane: Mitsuha"
},
{
"beatmap_id": 1276292,
"difficulty_ctb": 3.00177,
"difficulty_mania": 2.62572,
"difficulty_std": 4.88894,
"difficulty_taiko": 3.81198,
"mode": 0,
"version": "Insane: Taki"
},
{
"beatmap_id": 1262433,
"difficulty_ctb": 3.47115,
"difficulty_mania": 2.62518,
"difficulty_std": 5.33507,
"difficulty_taiko": 3.5303,
"mode": 0,
"version": "Extra: Mitsuha"
},
{
"beatmap_id": 1262434,
"difficulty_ctb": 3.566,
"difficulty_mania": 2.71756,
"difficulty_std": 5.39017,
"difficulty_taiko": 3.53029,
"mode": 0,
"version": "Extra: Taki"
}
],
"beatmapset_id": 597111,
"creator": "Monstrata",
"favourite_count": 6,
"passcount": 4599,
"playcount": 28314,
"ranked": 2,
"ranked_status_freezed": 0,
"ranking_data": 1495631889,
"title": "Yume Tourou"
}
]
}User's historical pp values ¶
Get user’s pp graph values as seen on the profile. Pairs in the array represent represent “how many days ago” in the first argument and pp value in the second.
Retrieve user's pp graph valuesGET/user/charts{?u,mode}
Example URI
GET https://api.gatari.pw/user/charts?u=1000&mode=0
URI Parameters
- u
Number(required) Example: 1000User’s id
- mode
Number(required) Example: 0Game mode
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"data": [
[
-59,
null
],
[
-58,
"15513"
],
[
-57,
"15513"
],
[
-56,
"15513"
],
[
-55,
"15513"
],
[
-54,
"15513"
],
[
-53,
"15513"
],
[
-52,
"15513"
],
[
-51,
"15513"
],
[
-50,
"15513"
],
[
-49,
"15513"
],
[
-48,
"15510"
],
[
-47,
"15510"
],
[
-46,
"15510"
],
[
-45,
"15510"
],
[
-44,
"15510"
],
[
-43,
"15510"
],
[
-42,
"15510"
],
[
-41,
"15510"
],
[
-40,
"15510"
],
[
-39,
"15510"
],
[
-38,
"15510"
],
[
-37,
"15510"
],
[
-36,
"15510"
],
[
-35,
"15510"
],
[
-34,
"15510"
],
[
-33,
"15510"
],
[
-32,
"15510"
],
[
-31,
"15510"
],
[
-30,
"15510"
],
[
-29,
"15510"
],
[
-28,
"15510"
],
[
-27,
"15510"
],
[
-26,
"15510"
],
[
-25,
"15510"
],
[
-24,
"15510"
],
[
-23,
"15510"
],
[
-22,
"15510"
],
[
-21,
"15510"
],
[
-20,
"15510"
],
[
-19,
"15510"
],
[
-18,
"15510"
],
[
-17,
"15510"
],
[
-16,
"15510"
],
[
-15,
"15510"
],
[
-14,
"15510"
],
[
-13,
"15510"
],
[
-12,
"15510"
],
[
-11,
"15510"
],
[
-10,
"15510"
],
[
-9,
"15510"
],
[
-8,
"15510"
],
[
-7,
"15510"
],
[
-6,
"15510"
],
[
-5,
"15510"
],
[
-4,
"15510"
],
[
-3,
"15510"
],
[
-2,
"15510"
],
[
-1,
"15510"
],
[
0,
"15510"
]
],
"high_limit": 18766,
"low_limit": 13959,
"value_ticks": [
-13959
]
}User's activity ¶
Get user’s activity as seen on profile. Always retrieves 5 last events.
data attribute represents additional information based on the event type.
- Event types:
- 0 other, such as lost first place
- 1 achievement unlocked
- 2 new rank on a map acquired
Retrieve user's activityGET/user/events{?u,mode}
Example URI
GET https://api.gatari.pw/user/events?u=1000&mode=0
URI Parameters
- u
Number(required) Example: 1000User’s id
- mode
Number(required) Example: 0Game mode
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"data": [
{
"data": [
35543074,
{
"rank": "S"
}
],
"id": 1440645,
"log": "achieved #4 rank on <a href='/b/1946302'>supercell - Mr.Downer [Insane]</a>",
"mode": 0,
"time": 1567162138,
"type": 2,
"userid": 1000
},
{
"data": [
35380315,
{
"rank": "A"
}
],
"id": 1426022,
"log": "achieved #7 rank on <a href='/b/281631'>OSTER project - Capriccio of My Mind [Extra AR10]</a>",
"mode": 0,
"time": 1566903410,
"type": 2,
"userid": 1000
},
{
"data": [
35377381,
{
"rank": "A"
}
],
"id": 1425782,
"log": "achieved #88 rank on <a href='/b/1536777'>nameless - Toumei Elegy [NiNo's Insane]</a>",
"mode": 0,
"time": 1566900151,
"type": 2,
"userid": 1000
},
{
"data": [
35377143,
{
"rank": "A"
}
],
"id": 1425758,
"log": "achieved #12 rank on <a href='/b/1649990'>THE ORAL CIGARETTES - ReI [NiNo's Insane]</a>",
"mode": 0,
"time": 1566899875,
"type": 2,
"userid": 1000
},
{
"data": [
35376499,
{
"rank": "A"
}
],
"id": 1425697,
"log": "achieved #9 rank on <a href='/b/856552'>Eiko Shimamiya - Higurashi no Naku Koro ni [Kihhou's Insane]</a>",
"mode": 0,
"time": 1566899124,
"type": 2,
"userid": 1000
}
]
}User's score on a map ¶
Get user’s score on a specific map
Retrieve user's score on a mapGET/beatmap/user/score{?b,u,mode}
Example URI
GET https://api.gatari.pw/beatmap/user/score?b=&u=Xxdstem&mode=
URI Parameters
- u
Number or String(required) Example: XxdstemEither numeric
idof the User or theirusername. If the user’s name is only digits, it is recommended to use numeric id- b
Number(required)Beatmap id
- mode
Number(required)Game mode
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"score": {
"accuracy": 99.190696716309,
"count_100": 5,
"count_300": 652,
"count_50": 0,
"count_miss": 2,
"id": 35281541,
"max_combo": 851,
"mods": 64,
"play_mode": 0,
"pp": 461.06,
"rank": "A",
"score": 14726069,
"time": 1566746939,
"top": 32
}
}Performance leaderboard ¶
Get pp leaderboard, 50 players per page.
Retrieve pp leaderboardGET/leaderboard/pp{?m,p,country}
Example URI
GET https://api.gatari.pw/leaderboard/pp?m=0&p=1&country=
URI Parameters
- m
Number(required) Example: 0Game mode
- p
Number(required) Example: 1Page number
- country
String(optional)2-letter country code. None will get all players
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"leaderboard": [
{
"playcount": 14467,
"ranked_score": 10749611534,
"accuracy": 98.397850036621,
"clan": {
"abbr": "WCC",
"id": 46
},
"active": true,
"pp": 15510,
"username": "WhiteCat",
"level": 100,
"country": "DE",
"user": 3079
},
{
"playcount": 5193,
"ranked_score": 2370242805,
"accuracy": 98.987342834473,
"clan": {
"abbr": "-GN",
"id": 3
},
"active": true,
"pp": 13950,
"username": "Hitomi",
"level": 97,
"country": "KR",
"user": 4246
},
{
"playcount": 22410,
"ranked_score": 9197500962,
"accuracy": 98.755432128906,
"clan": {
"abbr": " ",
"id": 152
},
"active": true,
"pp": 13324,
"username": "akia",
"level": 100,
"country": "RU",
"user": 1439
},
{
"playcount": 21457,
"ranked_score": 7336796478,
"accuracy": 98.370887756348,
"clan": {
"abbr": "DDy",
"id": 265
},
"active": true,
"pp": 13033,
"username": "D I V I N I T Y",
"level": 100,
"country": "JP",
"user": 1088
},
{
"playcount": 9816,
"ranked_score": 2788866928,
"accuracy": 98.765884399414,
"clan": {
"abbr": "KEK",
"id": 60
},
"active": true,
"pp": 12007,
"username": "Aki",
"level": 99,
"country": "UA",
"user": 1137
},
{
"playcount": 14949,
"ranked_score": 21064878598,
"accuracy": 98.973648071289,
"active": true,
"pp": 11652,
"username": "Haenes",
"level": 100,
"country": "RU",
"user": 1003
},
{
"playcount": 25232,
"ranked_score": 11097160763,
"accuracy": 95.45630645752,
"clan": {
"abbr": "APA",
"id": 947
},
"active": true,
"pp": 11268,
"username": "Kiruri",
"level": 100,
"country": "KZ",
"user": 3436
},
{
"playcount": 18733,
"ranked_score": 11979525599,
"accuracy": 99.226631164551,
"clan": {
"abbr": "owo",
"id": 14
},
"active": false,
"pp": 11200,
"username": "loli is gay",
"level": 100,
"country": "EE",
"user": 2418
},
{
"playcount": 71203,
"ranked_score": 38233313663,
"accuracy": 98.35228729248,
"clan": {
"abbr": "ORI",
"id": 803
},
"active": true,
"pp": 11186,
"username": "Meniwa",
"level": 102,
"country": "RU",
"user": 1093
},
{
"playcount": 16470,
"ranked_score": 17475024748,
"accuracy": 98.54369354248,
"clan": {
"abbr": "KEK",
"id": 60
},
"active": true,
"pp": 11131,
"username": "6e3Dapb",
"level": 100,
"country": "BY",
"user": 1007
},
{
"playcount": 34151,
"ranked_score": 3978047028,
"accuracy": 96.713317871094,
"clan": {
"abbr": "PLS",
"id": 286
},
"active": true,
"pp": 10941,
"username": "Ilitria",
"level": 100,
"country": "RU",
"user": 7333
},
{
"playcount": 10036,
"ranked_score": 7221635535,
"accuracy": 98.900428771973,
"active": true,
"pp": 10934,
"username": "yatogamitohka",
"level": 100,
"country": "KR",
"user": 13353
},
{
"playcount": 5383,
"ranked_score": 3941120804,
"accuracy": 98.412712097168,
"clan": {
"abbr": "pit",
"id": 209
},
"active": true,
"pp": 10817,
"username": "NoxiK",
"level": 97,
"country": "BR",
"user": 13043
},
{
"playcount": 2613,
"ranked_score": 4462820967,
"accuracy": 99.105751037598,
"clan": {
"abbr": "owo",
"id": 14
},
"active": false,
"pp": 10808,
"username": "Mathi",
"level": 97,
"country": "CL",
"user": 4205
},
{
"playcount": 966,
"ranked_score": 7169322404,
"accuracy": 99.36840057373,
"clan": {
"abbr": "owo",
"id": 14
},
"active": true,
"pp": 10775,
"username": "Mshake",
"level": 98,
"country": "US",
"user": 3889
},
{
"playcount": 3585,
"ranked_score": 4817170361,
"accuracy": 99.301795959473,
"clan": {
"abbr": "ReA",
"id": 816
},
"active": true,
"pp": 10731,
"username": "Lemon",
"level": 98,
"country": "JP",
"user": 3102
},
{
"playcount": 490,
"ranked_score": 453519405,
"accuracy": 97.31950378418,
"active": true,
"pp": 10620,
"username": "Ponytail",
"level": 54,
"country": "KR",
"user": 15025
},
{
"playcount": 5878,
"ranked_score": 6877869893,
"accuracy": 99.085647583008,
"active": true,
"pp": 10426,
"username": "Feaurors",
"level": 99,
"country": "BR",
"user": 5472
},
{
"playcount": 10995,
"ranked_score": 3141317055,
"accuracy": 98.520057678223,
"clan": {
"abbr": "KEK",
"id": 60
},
"active": true,
"pp": 10426,
"username": "NotSoFast_Dota",
"level": 98,
"country": "RU",
"user": 2665
},
{
"playcount": 20025,
"ranked_score": 8822496464,
"accuracy": 97.171203613281,
"clan": {
"abbr": "-GN",
"id": 3
},
"active": true,
"pp": 10354,
"username": "[TAKA]",
"level": 100,
"country": "KR",
"user": 4321
},
{
"playcount": 29486,
"ranked_score": 47108231274,
"accuracy": 99.053726196289,
"active": true,
"pp": 10328,
"username": "dedzodor",
"level": 101,
"country": "MG",
"user": 1001
},
{
"playcount": 25129,
"ranked_score": 13407232366,
"accuracy": 98.849555969238,
"clan": {
"abbr": "WCC",
"id": 46
},
"active": true,
"pp": 10299,
"username": "dude",
"level": 100,
"country": "DE",
"user": 3092
},
{
"playcount": 47247,
"ranked_score": 16882925878,
"accuracy": 98.755264282227,
"clan": {
"abbr": "MHS",
"id": 13
},
"active": true,
"pp": 10292,
"username": "Dlanor",
"level": 100,
"country": "RU",
"user": 1116
},
{
"playcount": 10598,
"ranked_score": 11641126004,
"accuracy": 98.919967651367,
"clan": {
"abbr": "KEK",
"id": 60
},
"active": true,
"pp": 10199,
"username": "Red_Pixel",
"level": 100,
"country": "RU",
"user": 1242
},
{
"playcount": 40001,
"ranked_score": 7959881076,
"accuracy": 98.18482208252,
"clan": {
"abbr": "pit",
"id": 209
},
"active": true,
"pp": 10096,
"username": "casagrande",
"level": 100,
"country": "TD",
"user": 7360
},
{
"playcount": 5160,
"ranked_score": 7158011582,
"accuracy": 99.098175048828,
"clan": {
"abbr": "ORI",
"id": 803
},
"active": true,
"pp": 10088,
"username": "Shiromaru",
"level": 99,
"country": "RU",
"user": 6063
},
{
"playcount": 3732,
"ranked_score": 3104943454,
"accuracy": 95.912391662598,
"active": false,
"pp": 10078,
"username": "howl",
"level": 98,
"country": "JP",
"user": 3181
},
{
"playcount": 3152,
"ranked_score": 1605046550,
"accuracy": 98.025886535645,
"active": true,
"pp": 10009,
"username": "Mystia",
"level": 95,
"country": "BR",
"user": 5497
},
{
"playcount": 36267,
"ranked_score": 9209760558,
"accuracy": 98.731475830078,
"clan": {
"abbr": "PLS",
"id": 286
},
"active": true,
"pp": 9842,
"username": "Twent",
"level": 100,
"country": "RU",
"user": 1992
},
{
"playcount": 1382,
"ranked_score": 3640863306,
"accuracy": 98.814811706543,
"clan": {
"abbr": "BIG",
"id": 653
},
"active": true,
"pp": 9771,
"username": "Stream Abuser",
"level": 96,
"country": "AU",
"user": 13775
},
{
"playcount": 8786,
"ranked_score": 6472739980,
"accuracy": 98.770683288574,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 9748,
"username": "zubs",
"level": 99,
"country": "IT",
"user": 11604
},
{
"playcount": 1088,
"ranked_score": 1252605169,
"accuracy": 98.317810058594,
"clan": {
"abbr": " ",
"id": 152
},
"active": true,
"pp": 9722,
"username": "_akia",
"level": 80,
"country": "KI",
"user": 4292
},
{
"playcount": 7316,
"ranked_score": 5951999337,
"accuracy": 98.64094543457,
"clan": {
"abbr": "DSK",
"id": 575
},
"active": true,
"pp": 9685,
"username": "lspin",
"level": 100,
"country": "KR",
"user": 13677
},
{
"playcount": 3140,
"ranked_score": 3249366128,
"accuracy": 99.239883422852,
"active": true,
"pp": 9522,
"username": "bruh",
"level": 97,
"country": "FI",
"user": 13659
},
{
"playcount": 9859,
"ranked_score": 8498422930,
"accuracy": 97.917427062988,
"clan": {
"abbr": "KEK",
"id": 60
},
"active": true,
"pp": 9485,
"username": "Abriel Lafiel",
"level": 100,
"country": "RU",
"user": 1206
},
{
"playcount": 12564,
"ranked_score": 8053340241,
"accuracy": 96.810707092285,
"clan": {
"abbr": "Sad",
"id": 234
},
"active": true,
"pp": 9391,
"username": "Chicony",
"level": 99,
"country": "FI",
"user": 2882
},
{
"playcount": 9456,
"ranked_score": 13886576538,
"accuracy": 99.24284362793,
"active": true,
"pp": 9342,
"username": "Sheba",
"level": 100,
"country": "JP",
"user": 5642
},
{
"playcount": 30113,
"ranked_score": 37709977063,
"accuracy": 99.024925231934,
"clan": {
"abbr": " ",
"id": 152
},
"active": true,
"pp": 9341,
"username": "HJY",
"level": 101,
"country": "KR",
"user": 7068
},
{
"playcount": 25120,
"ranked_score": 11447833978,
"accuracy": 98.444496154785,
"active": true,
"pp": 9337,
"username": "nomaiza",
"level": 100,
"country": "TR",
"user": 1221
},
{
"playcount": 14978,
"ranked_score": 4811246152,
"accuracy": 97.081161499023,
"clan": {
"abbr": "WCC",
"id": 46
},
"active": true,
"pp": 9335,
"username": "jeune",
"level": 99,
"country": "FI",
"user": 10804
},
{
"playcount": 6943,
"ranked_score": 8413296395,
"accuracy": 97.187278747559,
"clan": {
"abbr": "MCG",
"id": 508
},
"active": true,
"pp": 9314,
"username": "LoliAngelie",
"level": 99,
"country": "CO",
"user": 11482
},
{
"playcount": 10585,
"ranked_score": 2724681349,
"accuracy": 97.637489318848,
"clan": {
"abbr": "KTH",
"id": 544
},
"active": true,
"pp": 9285,
"username": "TrueDantist",
"level": 97,
"country": "SY",
"user": 9448
},
{
"playcount": 680,
"ranked_score": 991466791,
"accuracy": 98.756149291992,
"active": false,
"pp": 9230,
"username": "Spare",
"level": 66,
"country": "GB",
"user": 4759
},
{
"playcount": 18688,
"ranked_score": 7067839911,
"accuracy": 97.960304260254,
"active": true,
"pp": 9200,
"username": "avilov",
"level": 100,
"country": "IM",
"user": 8942
},
{
"playcount": 13142,
"ranked_score": 17616577786,
"accuracy": 99.682838439941,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 9168,
"username": "Lymsleia",
"level": 100,
"country": "AU",
"user": 7247
},
{
"playcount": 4515,
"ranked_score": 6195876067,
"accuracy": 98.599594116211,
"clan": {
"abbr": "DSK",
"id": 575
},
"active": true,
"pp": 9127,
"username": "Pray fan boy",
"level": 99,
"country": "KR",
"user": 4809
},
{
"playcount": 3959,
"ranked_score": 2404943024,
"accuracy": 99.145790100098,
"active": true,
"pp": 9077,
"username": "dunois",
"level": 96,
"country": "CA",
"user": 13317
},
{
"playcount": 285,
"ranked_score": 169485664,
"accuracy": 97.895378112793,
"active": true,
"pp": 9008,
"username": "achei facil",
"level": 39,
"country": "BR",
"user": 12976
},
{
"playcount": 57617,
"ranked_score": 22062494474,
"accuracy": 98.431053161621,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 8977,
"username": "Sharpsight",
"level": 101,
"country": "RU",
"user": 3538
},
{
"playcount": 4938,
"ranked_score": 5341775983,
"accuracy": 98.60888671875,
"active": true,
"pp": 8948,
"username": "Halsgarrotte",
"level": 99,
"country": "DE",
"user": 1065
}
]
}Ranked score leaderboard ¶
Get ranked score leaderboard, 50 players per page.
Retrieve ranked score leaderboardGET/leaderboard/score{?m,p,country}
Example URI
GET https://api.gatari.pw/leaderboard/score?m=0&p=1&country=
URI Parameters
- m
Number(required) Example: 0Game mode
- p
Number(required) Example: 1Page number
- country
String(optional)2-letter country code. None will get all players
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"leaderboard": [
{
"playcount": 73369,
"ranked_score": 79183691975,
"accuracy": 98.934310913086,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 8624,
"username": "Narkvar",
"level": 102,
"country": "NO",
"user": 1151
},
{
"playcount": 53056,
"ranked_score": 57082500801,
"accuracy": 98.933769226074,
"clan": {
"abbr": "EZZ",
"id": 315
},
"active": true,
"pp": 7406,
"username": "True_kek",
"level": 101,
"country": "SC",
"user": 2002
},
{
"playcount": 29501,
"ranked_score": 47108231274,
"accuracy": 99.053726196289,
"active": true,
"pp": 10328,
"username": "dedzodor",
"level": 101,
"country": "MG",
"user": 1001
},
{
"playcount": 71235,
"ranked_score": 38255997855,
"accuracy": 98.367797851562,
"clan": {
"abbr": "ORI",
"id": 803
},
"active": true,
"pp": 11198,
"username": "Meniwa",
"level": 102,
"country": "RU",
"user": 1093
},
{
"playcount": 30113,
"ranked_score": 37709977063,
"accuracy": 99.024925231934,
"clan": {
"abbr": " ",
"id": 152
},
"active": true,
"pp": 9341,
"username": "HJY",
"level": 101,
"country": "KR",
"user": 7068
},
{
"playcount": 22333,
"ranked_score": 34525184260,
"accuracy": 98.693435668945,
"clan": {
"abbr": "pit",
"id": 209
},
"active": true,
"pp": 8135,
"username": "luv",
"level": 100,
"country": "TD",
"user": 6656
},
{
"playcount": 25622,
"ranked_score": 33619194860,
"accuracy": 99.31859588623,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 6073,
"username": "Lkxemmeji",
"level": 100,
"country": "RU",
"user": 4874
},
{
"playcount": 38022,
"ranked_score": 32212858243,
"accuracy": 98.475059509277,
"clan": {
"abbr": "MLG",
"id": 233
},
"active": true,
"pp": 6183,
"username": "Axion299",
"level": 100,
"country": "FI",
"user": 1179
},
{
"playcount": 41170,
"ranked_score": 29762615795,
"accuracy": 98.715705871582,
"clan": {
"abbr": "KEK",
"id": 60
},
"active": true,
"pp": 8202,
"username": "moralfag",
"level": 100,
"country": "RU",
"user": 1070
},
{
"playcount": 25140,
"ranked_score": 28166044708,
"accuracy": 99.168258666992,
"clan": {
"abbr": "EZZ",
"id": 315
},
"active": true,
"pp": 6689,
"username": "Dick_In_Mouth",
"level": 100,
"country": "UA",
"user": 3996
},
{
"playcount": 20965,
"ranked_score": 23091980214,
"accuracy": 98.659652709961,
"clan": {
"abbr": "MLG",
"id": 233
},
"active": true,
"pp": 4699,
"username": "WiseHolo",
"level": 100,
"country": "BB",
"user": 2520
},
{
"playcount": 57617,
"ranked_score": 22062494474,
"accuracy": 98.431053161621,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 8977,
"username": "Sharpsight",
"level": 101,
"country": "RU",
"user": 3538
},
{
"playcount": 47929,
"ranked_score": 21807059167,
"accuracy": 99.088455200195,
"clan": {
"abbr": "MLG",
"id": 233
},
"active": true,
"pp": 4184,
"username": "shock15",
"level": 100,
"country": "BB",
"user": 3935
},
{
"playcount": 14949,
"ranked_score": 21064878598,
"accuracy": 98.973648071289,
"active": true,
"pp": 11652,
"username": "Haenes",
"level": 100,
"country": "RU",
"user": 1003
},
{
"playcount": 34509,
"ranked_score": 21031671600,
"accuracy": 96.720878601074,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 6263,
"username": "Eirin Yagokoro",
"level": 100,
"country": "RS",
"user": 1153
},
{
"playcount": 26759,
"ranked_score": 20583982929,
"accuracy": 98.359352111816,
"active": true,
"pp": 8075,
"username": "s l e e p y",
"level": 100,
"country": "ussr",
"user": 7155
},
{
"playcount": 12578,
"ranked_score": 20314320388,
"accuracy": 97.656448364258,
"clan": {
"abbr": "^.^",
"id": 358
},
"active": true,
"pp": 4480,
"username": "beetflasher",
"level": 100,
"country": "RU",
"user": 2056
},
{
"playcount": 6629,
"ranked_score": 18686826518,
"accuracy": 98.223403930664,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 7297,
"username": "Satanael",
"level": 100,
"country": "RU",
"user": 12104
},
{
"playcount": 18192,
"ranked_score": 18582351513,
"accuracy": 98.670104980469,
"clan": {
"abbr": "Roy",
"id": 146
},
"active": true,
"pp": 6975,
"username": "ZyzzelDESU",
"level": 100,
"country": "IN",
"user": 1859
},
{
"playcount": 60185,
"ranked_score": 17748211429,
"accuracy": 99.157936096191,
"clan": {
"abbr": "EZZ",
"id": 315
},
"active": true,
"pp": 7056,
"username": "DaHuJka",
"level": 100,
"country": "RU",
"user": 2746
},
{
"playcount": 13142,
"ranked_score": 17616577786,
"accuracy": 99.682838439941,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 9168,
"username": "Lymsleia",
"level": 100,
"country": "AU",
"user": 7247
},
{
"playcount": 16470,
"ranked_score": 17475024748,
"accuracy": 98.54369354248,
"clan": {
"abbr": "KEK",
"id": 60
},
"active": true,
"pp": 11131,
"username": "6e3Dapb",
"level": 100,
"country": "BY",
"user": 1007
},
{
"playcount": 29543,
"ranked_score": 16959740673,
"accuracy": 98.712257385254,
"clan": {
"abbr": "MLL",
"id": 941
},
"active": true,
"pp": 8176,
"username": "Lantana",
"level": 100,
"country": "KR",
"user": 4352
},
{
"playcount": 6713,
"ranked_score": 16903668056,
"accuracy": 99.16382598877,
"active": false,
"pp": 4685,
"username": "Remus",
"level": 100,
"country": "RU",
"user": 1056
},
{
"playcount": 47247,
"ranked_score": 16882925878,
"accuracy": 98.755264282227,
"clan": {
"abbr": "MHS",
"id": 13
},
"active": true,
"pp": 10292,
"username": "Dlanor",
"level": 100,
"country": "RU",
"user": 1116
},
{
"playcount": 13812,
"ranked_score": 15390156245,
"accuracy": 99.469985961914,
"clan": {
"abbr": "EZZ",
"id": 315
},
"active": true,
"pp": 6916,
"username": "EvilZone",
"level": 100,
"country": "RU",
"user": 3975
},
{
"playcount": 17176,
"ranked_score": 15335632612,
"accuracy": 99.01042175293,
"clan": {
"abbr": "MLG",
"id": 233
},
"active": true,
"pp": 5895,
"username": "Lord Abaddon",
"level": 100,
"country": "RU",
"user": 6246
},
{
"playcount": 59848,
"ranked_score": 14952158284,
"accuracy": 99.296997070312,
"clan": {
"abbr": "N_S",
"id": 328
},
"active": true,
"pp": 6297,
"username": "coldisice",
"level": 100,
"country": "TW",
"user": 8163
},
{
"playcount": 84501,
"ranked_score": 14501442935,
"accuracy": 98.082733154297,
"clan": {
"abbr": "IRB",
"id": 1035
},
"active": true,
"pp": 7988,
"username": "Xxdstem",
"level": 100,
"country": "RU",
"user": 1000
},
{
"playcount": 32792,
"ranked_score": 14280786419,
"accuracy": 98.92244720459,
"clan": {
"abbr": "MLG",
"id": 233
},
"active": true,
"pp": 5352,
"username": "Winni_Pu-San",
"level": 100,
"country": "BB",
"user": 2208
},
{
"playcount": 25807,
"ranked_score": 14125018396,
"accuracy": 98.157028198242,
"clan": {
"abbr": "AYE",
"id": 92
},
"active": true,
"pp": 5991,
"username": "XLON",
"level": 100,
"country": "RU",
"user": 2995
},
{
"playcount": 63912,
"ranked_score": 13916092782,
"accuracy": 98.576416015625,
"clan": {
"abbr": "Sad",
"id": 234
},
"active": true,
"pp": 7821,
"username": "DixAway",
"level": 100,
"country": "RU",
"user": 2962
},
{
"playcount": 9456,
"ranked_score": 13886576538,
"accuracy": 99.24284362793,
"active": true,
"pp": 9342,
"username": "Sheba",
"level": 100,
"country": "JP",
"user": 5642
},
{
"playcount": 25129,
"ranked_score": 13407232366,
"accuracy": 98.849555969238,
"clan": {
"abbr": "WCC",
"id": 46
},
"active": true,
"pp": 10299,
"username": "dude",
"level": 100,
"country": "DE",
"user": 3092
},
{
"playcount": 28937,
"ranked_score": 13355529257,
"accuracy": 99.100471496582,
"active": true,
"pp": 5681,
"username": "Lucky13",
"level": 100,
"country": "ussr",
"user": 1480
},
{
"playcount": 27376,
"ranked_score": 13338595233,
"accuracy": 98.72541809082,
"active": true,
"pp": 5196,
"username": "karmalev",
"level": 100,
"country": "RU",
"user": 4466
},
{
"playcount": 46354,
"ranked_score": 13239381069,
"accuracy": 98.111061096191,
"clan": {
"abbr": "Loh",
"id": 29
},
"active": true,
"pp": 7740,
"username": "KrYuTiCk",
"level": 100,
"country": "KZ",
"user": 2946
},
{
"playcount": 50149,
"ranked_score": 13073384879,
"accuracy": 97.516044616699,
"active": true,
"pp": 8357,
"username": "Jaster56",
"level": 100,
"country": "JP",
"user": 4349
},
{
"playcount": 11693,
"ranked_score": 13059330696,
"accuracy": 96.161842346191,
"clan": {
"abbr": "rei",
"id": 455
},
"active": true,
"pp": 5473,
"username": "Reimu Hakurei",
"level": 99,
"country": "JP",
"user": 9270
},
{
"playcount": 36701,
"ranked_score": 12973946269,
"accuracy": 98.118011474609,
"clan": {
"abbr": "BIB",
"id": 82
},
"active": true,
"pp": 5024,
"username": "AyashiruSenpai",
"level": 100,
"country": "JP",
"user": 3578
},
{
"playcount": 5228,
"ranked_score": 12874103043,
"accuracy": 98.762489318848,
"active": true,
"pp": 6060,
"username": "alone",
"level": 99,
"country": "RU",
"user": 12050
},
{
"playcount": 39619,
"ranked_score": 12673333225,
"accuracy": 98.463821411133,
"clan": {
"abbr": " ",
"id": 152
},
"active": true,
"pp": 8835,
"username": "blue",
"level": 100,
"country": "KR",
"user": 6851
},
{
"playcount": 28484,
"ranked_score": 12540749782,
"accuracy": 98.031929016113,
"clan": {
"abbr": "3o4",
"id": 327
},
"active": true,
"pp": 5626,
"username": "fenix_105",
"level": 100,
"country": "RU",
"user": 1113
},
{
"playcount": 28055,
"ranked_score": 12420223618,
"accuracy": 97.751991271973,
"clan": {
"abbr": "MKS",
"id": 980
},
"active": true,
"pp": 7003,
"username": "sadjelly",
"level": 100,
"country": "MD",
"user": 6895
},
{
"playcount": 11248,
"ranked_score": 12378032111,
"accuracy": 97.570556640625,
"active": true,
"pp": 5830,
"username": "Megupoid GUMI",
"level": 100,
"country": "KR",
"user": 9422
},
{
"playcount": 35298,
"ranked_score": 12286143511,
"accuracy": 98.837554931641,
"clan": {
"abbr": "lox",
"id": 30
},
"active": true,
"pp": 6940,
"username": "ASDofe",
"level": 100,
"country": "IS",
"user": 3376
},
{
"playcount": 16371,
"ranked_score": 12161829349,
"accuracy": 98.63550567627,
"active": true,
"pp": 6925,
"username": "Komachi",
"level": 100,
"country": "CN",
"user": 1108
},
{
"playcount": 33044,
"ranked_score": 11995926478,
"accuracy": 98.243125915527,
"clan": {
"abbr": "EXE",
"id": 447
},
"active": true,
"pp": 7119,
"username": "CrazyCondoms",
"level": 100,
"country": "JP",
"user": 1610
},
{
"playcount": 18733,
"ranked_score": 11979525599,
"accuracy": 99.226631164551,
"clan": {
"abbr": "owo",
"id": 14
},
"active": false,
"pp": 11200,
"username": "loli is gay",
"level": 100,
"country": "EE",
"user": 2418
},
{
"playcount": 22765,
"ranked_score": 11913245730,
"accuracy": 98.801246643066,
"clan": {
"abbr": "AYE",
"id": 92
},
"active": true,
"pp": 5620,
"username": "Yui",
"level": 100,
"country": "RU",
"user": 2227
}
]
}Clans leaderboard ¶
Get clans leaderboard, 50 clans per page.
Retrieve clans leaderboardGET/leaderboard/clans{?p}
Example URI
GET https://api.gatari.pw/leaderboard/clans?p=1
URI Parameters
- p
Number(required) Example: 1Page number
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"result": [
{
"abbr": "KEK",
"creator": "6e3Dapb",
"creator_id": 1007,
"id": 60,
"members": 10,
"name": "CJlaBa Pycu",
"performance": 31292
},
{
"abbr": " ",
"creator": "akia",
"creator_id": 1439,
"id": 152,
"members": 10,
"name": "",
"performance": 23320
},
{
"abbr": "pit",
"creator": "tusabimete",
"creator_id": 6645,
"id": 209,
"members": 10,
"name": "MacacosNegros",
"performance": 20682
},
{
"abbr": "EXE",
"creator": "Narkvar",
"creator_id": 1151,
"id": 447,
"members": 9,
"name": "EXEC_LINCA/.",
"performance": 16787
},
{
"abbr": "WCC",
"creator": "WhiteCat",
"creator_id": 3079,
"id": 46,
"members": 9,
"name": "WhiteCatsClan",
"performance": 16625
},
{
"abbr": "-GN",
"creator": "firedigger",
"creator_id": 1015,
"id": 3,
"members": 9,
"name": "Gaen network",
"performance": 16378
},
{
"abbr": "owo",
"creator": "loli is gay",
"creator_id": 2418,
"id": 14,
"members": 9,
"name": "asdf",
"performance": 15827
},
{
"abbr": "EZZ",
"creator": "_Alice_K",
"creator_id": 9227,
"id": 315,
"members": 10,
"name": "Legends",
"performance": 13097
},
{
"abbr": "ORI",
"creator": "Flaizy",
"creator_id": 3584,
"id": 803,
"members": 9,
"name": "ORIFLAME",
"performance": 12383
},
{
"abbr": "MHS",
"creator": "MyAngelHomura",
"creator_id": 1254,
"id": 13,
"members": 10,
"name": "Mahou Shoujo",
"performance": 9868
},
{
"abbr": "AYE",
"creator": "sukiKanade",
"creator_id": 4057,
"id": 92,
"members": 10,
"name": "Aye Squad",
"performance": 9690
},
{
"abbr": "DSK",
"creator": "-GL",
"creator_id": 13191,
"id": 575,
"members": 10,
"name": "Daisuke",
"performance": 9678
},
{
"abbr": "lox",
"creator": "Tutris",
"creator_id": 2525,
"id": 30,
"members": 10,
"name": "Loxi",
"performance": 9649
},
{
"abbr": "MEK",
"creator": "hikikomori",
"creator_id": 2600,
"id": 108,
"members": 10,
"name": "REALasdf",
"performance": 9087
},
{
"abbr": "MLG",
"creator": "Suwako Moriya",
"creator_id": 6523,
"id": 233,
"members": 10,
"name": "MeLoveGatari",
"performance": 8646
},
{
"abbr": "WLC",
"creator": "Snowy Spring",
"creator_id": 2715,
"id": 193,
"members": 10,
"name": ":wheelchair:",
"performance": 8308
},
{
"abbr": "S+L",
"creator": "F3L",
"creator_id": 3903,
"id": 40,
"members": 5,
"name": "S0S4T+L3J4T",
"performance": 8246
},
{
"abbr": "MLL",
"creator": "Park Yu Hyun",
"creator_id": 13089,
"id": 941,
"members": 6,
"name": "MyLifeLegend",
"performance": 7765
},
{
"abbr": "Sad",
"creator": "chick",
"creator_id": 2200,
"id": 234,
"members": 6,
"name": "Insomnia",
"performance": 7211
},
{
"abbr": "OLD",
"creator": "aaaaa",
"creator_id": 2405,
"id": 361,
"members": 10,
"name": "OLDMANS",
"performance": 7073
},
{
"abbr": "DIE",
"creator": "Spiroww",
"creator_id": 1488,
"id": 540,
"members": 10,
"name": "KIllYOurSElf",
"performance": 7037
},
{
"abbr": "KTK",
"creator": "jonstrok",
"creator_id": 2747,
"id": 332,
"members": 10,
"name": "BAM_COCET",
"performance": 6970
},
{
"abbr": "the",
"creator": "Willy",
"creator_id": 5032,
"id": 62,
"members": 8,
"name": "brogamers",
"performance": 6767
},
{
"abbr": "BIB",
"creator": "Yueliang",
"creator_id": 5276,
"id": 82,
"members": 10,
"name": "BIsexualBoys",
"performance": 6562
},
{
"abbr": "BzR",
"creator": "Ploy",
"creator_id": 5760,
"id": 624,
"members": 9,
"name": "BruskaZRuska",
"performance": 6478
}
]
}Beatmap scores ¶
Get scores on a specific beatmap
Retrieve beatmap scoresGET/beatmap/{id}/scores{?mode}
Example URI
GET https://api.gatari.pw/beatmap/1954587/scores?mode=0
URI Parameters
- mode
Number(required) Example: 0Game mode
- id
Number(required) Example: 1954587Beatmap id
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"data": [
{
"accuracy": 99.744575500488,
"count_100": 1,
"count_300": 260,
"count_50": 0,
"count_miss": 0,
"country": "CO",
"fc": 386,
"friend": 0,
"id": 35020306,
"max_combo": 386,
"mods": 24,
"play_mode": 0,
"pp": 406.64,
"rank": "SH",
"score": 3525769,
"time": 1566344321,
"userid": 11482,
"username": "[MCG] LoliAngelie"
},
{
"accuracy": 100,
"count_100": 0,
"count_300": 261,
"count_50": 0,
"count_miss": 0,
"country": "CZ",
"fc": 386,
"friend": 0,
"id": 35336432,
"max_combo": 386,
"mods": 16,
"play_mode": 0,
"pp": 387.93,
"rank": "X",
"score": 3340824,
"time": 1566830617,
"userid": 5848,
"username": "[BzR] Mvnd"
},
{
"accuracy": 98.722862243652,
"count_100": 5,
"count_300": 256,
"count_50": 0,
"count_miss": 0,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35429004,
"max_combo": 386,
"mods": 16,
"play_mode": 0,
"pp": 341.62,
"rank": "S",
"score": 3327046,
"time": 1566983842,
"userid": 2183,
"username": "[AYE] Ahrome"
},
{
"accuracy": 99.106002807617,
"count_100": 2,
"count_300": 258,
"count_50": 0,
"count_miss": 1,
"country": "LV",
"fc": 386,
"friend": 0,
"id": 35438137,
"max_combo": 385,
"mods": 16,
"play_mode": 0,
"pp": 343.83,
"rank": "A",
"score": 3297101,
"time": 1566993276,
"userid": 6528,
"username": "fl0w"
},
{
"accuracy": 99.489143371582,
"count_100": 2,
"count_300": 259,
"count_50": 0,
"count_miss": 0,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35375456,
"max_combo": 386,
"mods": 0,
"play_mode": 0,
"pp": 304.43,
"rank": "S",
"score": 3148830,
"time": 1566897882,
"userid": 3005,
"username": "penisita"
},
{
"accuracy": 99.744575500488,
"count_100": 1,
"count_300": 260,
"count_50": 0,
"count_miss": 0,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35407451,
"max_combo": 386,
"mods": 0,
"play_mode": 0,
"pp": 312.37,
"rank": "S",
"score": 3146070,
"time": 1566932279,
"userid": 2962,
"username": "[Sad] DixAway"
},
{
"accuracy": 98.978286743164,
"count_100": 4,
"count_300": 257,
"count_50": 0,
"count_miss": 0,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35484140,
"max_combo": 385,
"mods": 0,
"play_mode": 0,
"pp": 290.45,
"rank": "S",
"score": 3136900,
"time": 1567069066,
"userid": 2583,
"username": "ruslan228911"
},
{
"accuracy": 96.807151794434,
"count_100": 11,
"count_300": 249,
"count_50": 0,
"count_miss": 1,
"country": "BR",
"fc": 386,
"friend": 0,
"id": 34967958,
"max_combo": 373,
"mods": 24,
"play_mode": 0,
"pp": 313.47,
"rank": "A",
"score": 3126151,
"time": 1566273525,
"userid": 5204,
"username": "[DSK] Naco"
},
{
"accuracy": 99.361427307129,
"count_100": 1,
"count_300": 259,
"count_50": 0,
"count_miss": 1,
"country": "AT",
"fc": 386,
"friend": 0,
"id": 35322639,
"max_combo": 385,
"mods": 0,
"play_mode": 0,
"pp": 293.07,
"rank": "A",
"score": 3118810,
"time": 1566816105,
"userid": 14040,
"username": "Samura1chik"
},
{
"accuracy": 96.934867858887,
"count_100": 12,
"count_300": 249,
"count_50": 0,
"count_miss": 0,
"country": "VA",
"fc": 386,
"friend": 0,
"id": 35330388,
"max_combo": 386,
"mods": 0,
"play_mode": 0,
"pp": 258.83,
"rank": "S",
"score": 3083230,
"time": 1566824488,
"userid": 3094,
"username": "[LSL] WelcomeToHell"
},
{
"accuracy": 97.701148986816,
"count_100": 9,
"count_300": 252,
"count_50": 0,
"count_miss": 0,
"country": "MR",
"fc": 386,
"friend": 0,
"id": 35008582,
"max_combo": 386,
"mods": 0,
"play_mode": 0,
"pp": 267.78,
"rank": "S",
"score": 3065590,
"time": 1566325626,
"userid": 4808,
"username": "[MHS] null"
},
{
"accuracy": 98.850578308105,
"count_100": 3,
"count_300": 257,
"count_50": 0,
"count_miss": 1,
"country": "KR",
"fc": 386,
"friend": 0,
"id": 35325009,
"max_combo": 381,
"mods": 0,
"play_mode": 0,
"pp": 278.37,
"rank": "A",
"score": 3030720,
"time": 1566818832,
"userid": 1466,
"username": "[AOD] TwistPlay"
},
{
"accuracy": 98.595146179199,
"count_100": 4,
"count_300": 256,
"count_50": 0,
"count_miss": 1,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35322155,
"max_combo": 381,
"mods": 0,
"play_mode": 0,
"pp": 272.97,
"rank": "A",
"score": 2999690,
"time": 1566815484,
"userid": 15398,
"username": "Yumemi"
},
{
"accuracy": 96.807151794434,
"count_100": 11,
"count_300": 249,
"count_50": 0,
"count_miss": 1,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35465372,
"max_combo": 384,
"mods": 0,
"play_mode": 0,
"pp": 249.42,
"rank": "A",
"score": 2987030,
"time": 1567022372,
"userid": 12705,
"username": "Kollxxxyoy"
},
{
"accuracy": 98.722862243652,
"count_100": 2,
"count_300": 257,
"count_50": 0,
"count_miss": 2,
"country": "NZ",
"fc": 386,
"friend": 0,
"id": 35260837,
"max_combo": 378,
"mods": 0,
"play_mode": 0,
"pp": 267.24,
"rank": "A",
"score": 2967120,
"time": 1566722833,
"userid": 4078,
"username": "[WCC] Choke"
},
{
"accuracy": 95.785438537598,
"count_100": 15,
"count_300": 245,
"count_50": 0,
"count_miss": 1,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35488170,
"max_combo": 384,
"mods": 0,
"play_mode": 0,
"pp": 241.56,
"rank": "A",
"score": 2951120,
"time": 1567073377,
"userid": 9265,
"username": "for1kill"
},
{
"accuracy": 92.848022460938,
"count_100": 28,
"count_300": 233,
"count_50": 0,
"count_miss": 0,
"country": "IS",
"fc": 386,
"friend": 0,
"id": 35364198,
"max_combo": 385,
"mods": 0,
"play_mode": 0,
"pp": 237.46,
"rank": "A",
"score": 2919720,
"time": 1566874428,
"userid": 4516,
"username": "[lox] Hanabi Shira"
},
{
"accuracy": 95.657730102539,
"count_100": 14,
"count_300": 245,
"count_50": 0,
"count_miss": 2,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35368895,
"max_combo": 377,
"mods": 0,
"play_mode": 0,
"pp": 230.56,
"rank": "A",
"score": 2882170,
"time": 1566889334,
"userid": 2524,
"username": "Neb SanlaydR"
},
{
"accuracy": 97.701148986816,
"count_100": 6,
"count_300": 253,
"count_50": 0,
"count_miss": 2,
"country": "KG",
"fc": 386,
"friend": 0,
"id": 35375928,
"max_combo": 374,
"mods": 0,
"play_mode": 0,
"pp": 247.89,
"rank": "A",
"score": 2881810,
"time": 1566898430,
"userid": 11705,
"username": "Riser"
},
{
"accuracy": 98.722862243652,
"count_100": 5,
"count_300": 256,
"count_50": 0,
"count_miss": 0,
"country": "IS",
"fc": 386,
"friend": 0,
"id": 35426320,
"max_combo": 367,
"mods": 0,
"play_mode": 0,
"pp": 275.71,
"rank": "S",
"score": 2729020,
"time": 1566980795,
"userid": 3376,
"username": "[lox] ASDofe"
},
{
"accuracy": 96.67943572998,
"count_100": 10,
"count_300": 249,
"count_50": 0,
"count_miss": 2,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35453274,
"max_combo": 367,
"mods": 0,
"play_mode": 0,
"pp": 233.28,
"rank": "A",
"score": 2696330,
"time": 1567008300,
"userid": 1499,
"username": "[mur] Huick"
},
{
"accuracy": 93.74201965332,
"count_100": 20,
"count_300": 238,
"count_50": 0,
"count_miss": 3,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35422209,
"max_combo": 369,
"mods": 0,
"play_mode": 0,
"pp": 212.16,
"rank": "A",
"score": 2679150,
"time": 1566974662,
"userid": 15002,
"username": "Allion"
},
{
"accuracy": 98.339721679688,
"count_100": 5,
"count_300": 255,
"count_50": 0,
"count_miss": 1,
"country": "US",
"fc": 386,
"friend": 0,
"id": 35477581,
"max_combo": 363,
"mods": 0,
"play_mode": 0,
"pp": 259.34,
"rank": "A",
"score": 2660230,
"time": 1567056313,
"userid": 15059,
"username": "teawix"
},
{
"accuracy": 87.867179870605,
"count_100": 43,
"count_300": 215,
"count_50": 0,
"count_miss": 3,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35477326,
"max_combo": 379,
"mods": 0,
"play_mode": 0,
"pp": 205.63,
"rank": "B",
"score": 2610640,
"time": 1567055459,
"userid": 12105,
"username": "Fishetora"
},
{
"accuracy": 98.212005615234,
"count_100": 4,
"count_300": 255,
"count_50": 0,
"count_miss": 2,
"country": "IL",
"fc": 386,
"friend": 0,
"id": 35317026,
"max_combo": 360,
"mods": 0,
"play_mode": 0,
"pp": 249.02,
"rank": "A",
"score": 2598490,
"time": 1566809148,
"userid": 13471,
"username": "Chim"
},
{
"accuracy": 97.701148986816,
"count_100": 3,
"count_300": 254,
"count_50": 0,
"count_miss": 4,
"country": "CO",
"fc": 386,
"friend": 0,
"id": 35297139,
"max_combo": 289,
"mods": 24,
"play_mode": 0,
"pp": 253.46,
"rank": "A",
"score": 2136531,
"time": 1566763850,
"userid": 14955,
"username": "Clippy"
},
{
"accuracy": 97.190292358398,
"count_100": 8,
"count_300": 251,
"count_50": 0,
"count_miss": 2,
"country": "PK",
"fc": 386,
"friend": 0,
"id": 35272664,
"max_combo": 288,
"mods": 24,
"play_mode": 0,
"pp": 257.71,
"rank": "A",
"score": 2122601,
"time": 1566737585,
"userid": 13191,
"username": "[DSK] -GL"
},
{
"accuracy": 97.701148986816,
"count_100": 6,
"count_300": 253,
"count_50": 0,
"count_miss": 2,
"country": "KR",
"fc": 386,
"friend": 0,
"id": 35336976,
"max_combo": 292,
"mods": 8,
"play_mode": 0,
"pp": 227.8,
"rank": "A",
"score": 2084204,
"time": 1566831225,
"userid": 6176,
"username": "[IRL] Gospel"
},
{
"accuracy": 96.551727294922,
"count_100": 9,
"count_300": 249,
"count_50": 0,
"count_miss": 3,
"country": "KZ",
"fc": 386,
"friend": 0,
"id": 35393540,
"max_combo": 292,
"mods": 8,
"play_mode": 0,
"pp": 208.56,
"rank": "A",
"score": 2007921,
"time": 1566917765,
"userid": 6813,
"username": "Kohiro"
},
{
"accuracy": 96.807151794434,
"count_100": 5,
"count_300": 251,
"count_50": 0,
"count_miss": 5,
"country": "JP",
"fc": 386,
"friend": 0,
"id": 35498474,
"max_combo": 286,
"mods": 8,
"play_mode": 0,
"pp": 196.67,
"rank": "A",
"score": 1947745,
"time": 1567085156,
"userid": 2580,
"username": "[Sad] InsaneMiracle"
},
{
"accuracy": 97.573432922363,
"count_100": 8,
"count_300": 252,
"count_50": 0,
"count_miss": 1,
"country": "UA",
"fc": 386,
"friend": 0,
"id": 35333935,
"max_combo": 258,
"mods": 8,
"play_mode": 0,
"pp": 212.85,
"rank": "A",
"score": 1862802,
"time": 1566828306,
"userid": 10008,
"username": "[N_S] -Jedpool"
},
{
"accuracy": 93.997444152832,
"count_100": 19,
"count_300": 239,
"count_50": 0,
"count_miss": 3,
"country": "EE",
"fc": 386,
"friend": 0,
"id": 35383885,
"max_combo": 283,
"mods": 16,
"play_mode": 0,
"pp": 204.99,
"rank": "A",
"score": 1849431,
"time": 1566907390,
"userid": 10053,
"username": "[Frx] TheArcaneZ"
},
{
"accuracy": 96.551727294922,
"count_100": 6,
"count_300": 250,
"count_50": 0,
"count_miss": 5,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35492547,
"max_combo": 284,
"mods": 0,
"play_mode": 0,
"pp": 176.56,
"rank": "A",
"score": 1847190,
"time": 1567079022,
"userid": 11331,
"username": "[AND] YourKun"
},
{
"accuracy": 97.956573486328,
"count_100": 5,
"count_300": 254,
"count_50": 0,
"count_miss": 2,
"country": "JP",
"fc": 386,
"friend": 0,
"id": 35406305,
"max_combo": 287,
"mods": 0,
"play_mode": 0,
"pp": 209.44,
"rank": "A",
"score": 1807560,
"time": 1566930862,
"userid": 8499,
"username": "[N_S] Ricotta"
},
{
"accuracy": 98.212005615234,
"count_100": 7,
"count_300": 254,
"count_50": 0,
"count_miss": 0,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35397443,
"max_combo": 261,
"mods": 8,
"play_mode": 0,
"pp": 230.56,
"rank": "SH",
"score": 1760718,
"time": 1566921732,
"userid": 10080,
"username": "bujhm023"
},
{
"accuracy": 97.445724487305,
"count_100": 7,
"count_300": 252,
"count_50": 0,
"count_miss": 2,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35338328,
"max_combo": 262,
"mods": 0,
"play_mode": 0,
"pp": 189.96,
"rank": "A",
"score": 1694080,
"time": 1566832753,
"userid": 13293,
"username": "LesnoyBOBR"
},
{
"accuracy": 97.701148986816,
"count_100": 6,
"count_300": 253,
"count_50": 0,
"count_miss": 2,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 34975951,
"max_combo": 252,
"mods": 8,
"play_mode": 0,
"pp": 205.78,
"rank": "A",
"score": 1673933,
"time": 1566291086,
"userid": 1474,
"username": "[OLD] laycher"
},
{
"accuracy": 97.062576293945,
"count_100": 7,
"count_300": 251,
"count_50": 0,
"count_miss": 3,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35409986,
"max_combo": 260,
"mods": 0,
"play_mode": 0,
"pp": 179.72,
"rank": "A",
"score": 1653350,
"time": 1566936329,
"userid": 15346,
"username": "Oratori"
},
{
"accuracy": 95.913154602051,
"count_100": 7,
"count_300": 248,
"count_50": 0,
"count_miss": 6,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35452639,
"max_combo": 252,
"mods": 0,
"play_mode": 0,
"pp": 152.92,
"rank": "A",
"score": 1593580,
"time": 1567007638,
"userid": 7296,
"username": "Fukushima"
},
{
"accuracy": 97.573432922363,
"count_100": 5,
"count_300": 253,
"count_50": 0,
"count_miss": 3,
"country": "AZ",
"fc": 386,
"friend": 0,
"id": 35319182,
"max_combo": 224,
"mods": 0,
"play_mode": 0,
"pp": 167.69,
"rank": "A",
"score": 1592650,
"time": 1566812010,
"userid": 11633,
"username": "[KPE] Shad0wBUBA"
},
{
"accuracy": 96.424011230469,
"count_100": 11,
"count_300": 248,
"count_50": 0,
"count_miss": 2,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35407347,
"max_combo": 248,
"mods": 0,
"play_mode": 0,
"pp": 172.82,
"rank": "A",
"score": 1484770,
"time": 1566932140,
"userid": 9919,
"username": "Rainou"
},
{
"accuracy": 98.084289550781,
"count_100": 0,
"count_300": 256,
"count_50": 0,
"count_miss": 5,
"country": "SC",
"fc": 386,
"friend": 0,
"id": 34956698,
"max_combo": 226,
"mods": 0,
"play_mode": 0,
"pp": 167.66,
"rank": "A",
"score": 1357830,
"time": 1566244003,
"userid": 2002,
"username": "[EZZ] True_kek"
},
{
"accuracy": 96.168579101562,
"count_100": 9,
"count_300": 248,
"count_50": 0,
"count_miss": 4,
"country": "DE",
"fc": 386,
"friend": 0,
"id": 35399745,
"max_combo": 213,
"mods": 0,
"play_mode": 0,
"pp": 144.56,
"rank": "A",
"score": 1246580,
"time": 1566923816,
"userid": 14798,
"username": "Nooky"
},
{
"accuracy": 87.037040710449,
"count_100": 36,
"count_300": 215,
"count_50": 1,
"count_miss": 9,
"country": "UA",
"fc": 386,
"friend": 0,
"id": 35500947,
"max_combo": 225,
"mods": 0,
"play_mode": 0,
"pp": 112.3,
"rank": "B",
"score": 1138690,
"time": 1567088131,
"userid": 7595,
"username": "[ICL] Sin GodOfDeda"
},
{
"accuracy": 92.592590332031,
"count_100": 17,
"count_300": 236,
"count_50": 0,
"count_miss": 8,
"country": "CA",
"fc": 386,
"friend": 0,
"id": 35349779,
"max_combo": 194,
"mods": 0,
"play_mode": 0,
"pp": 108.33,
"rank": "A",
"score": 964120,
"time": 1566844925,
"userid": 10424,
"username": "[com] Signore"
},
{
"accuracy": 92.848022460938,
"count_100": 19,
"count_300": 236,
"count_50": 0,
"count_miss": 6,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35327322,
"max_combo": 155,
"mods": 0,
"play_mode": 0,
"pp": 96.87,
"rank": "A",
"score": 773630,
"time": 1566821292,
"userid": 10054,
"username": "BooBaa"
},
{
"accuracy": 94.50830078125,
"count_100": 11,
"count_300": 243,
"count_50": 0,
"count_miss": 7,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35424143,
"max_combo": 116,
"mods": 16,
"play_mode": 0,
"pp": 93.99,
"rank": "A",
"score": 741946,
"time": 1566978228,
"userid": 10755,
"username": "[MRL] Donnielul"
},
{
"accuracy": 90.293739318848,
"count_100": 22,
"count_300": 228,
"count_50": 2,
"count_miss": 9,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35456160,
"max_combo": 115,
"mods": 8,
"play_mode": 0,
"pp": 73.88,
"rank": "B",
"score": 663992,
"time": 1567011174,
"userid": 4874,
"username": "[EXE] Lkxemmeji"
},
{
"accuracy": 89.144317626953,
"count_100": 29,
"count_300": 223,
"count_50": 0,
"count_miss": 9,
"country": "RU",
"fc": 386,
"friend": 0,
"id": 35463340,
"max_combo": 76,
"mods": 0,
"play_mode": 0,
"pp": 48.01,
"rank": "B",
"score": 430990,
"time": 1567020032,
"userid": 9425,
"username": "[WFS] Lirtina"
}
]
}Beatmap information ¶
Get beatmap information. Version means difficulty name.
Retrieve beatmapGET/beatmaps/get{?bb}
Example URI
GET https://api.gatari.pw/beatmaps/get?bb=1052575
URI Parameters
- bb
Number(required) Example: 1052575Beatmap id
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"data": [
{
"ar": 9.3,
"artist": "Rie Tanaka, Asami Imai, Kana Asumi, Rina Satoh",
"beatmap_id": 1052575,
"beatmapset_id": 494343,
"bpm": 180,
"cs": 4,
"difficulty_ctb": 5.06854,
"difficulty_mania": 2.87059,
"difficulty_std": 6.16271,
"difficulty_taiko": 4.63409,
"hit_length": 242,
"hp": 5,
"mode": 0,
"od": 9,
"ranked": 2,
"ranked_status_freezed": 1,
"ranking_data": 1567087637,
"rating": 0,
"title": "Mousou 4tune",
"version": "G"
}
]
}Calculate pp for a map ¶
Calculate pp for a score on map using score parameters. Note that this is the only method which is requested from http://osu.gatari.pw .
Retrieve pp for a score on mapGET/letsapi/v1/pp{?b,a,x,c,m}
Example URI
GET https://osu.gatari.pw/letsapi/v1/pp?b=1052575&a=100&x=0&c=0&m=0
URI Parameters
- b
Number(required) Example: 1052575Beatmap id
- a
Number(required) Example: 100Accuracy
- x
Number(required) Example: 0Misses count
- c
Number(required) Example: 0Max combo. None means full combo
- m
Number(required) Example: 0Mods
Response
200Headers
Content-Type: application/jsonBody
{
"stars": 2.3134145736694,
"message": "ok",
"song_name": "M.Iz - Kakenukeru Anime Song Medley IV [TWO DIMENSIONS]",
"bpm": 192,
"pp": [
132.76
],
"od": 8,
"ar": 9,
"status": 200,
"length": 734
}Get top pp plays of gatari by period ¶
Get top pp plays of gatari of all time, this month or this week.
Retrieve gatari top pp playsGET/top_scores{?mode,period}
Example URI
GET https://api.gatari.pw/top_scores?mode=0&period=all
URI Parameters
- mode
Number(required) Example: 0Game mode
- period
Number(required) Example: allall, month, week
Response
200Headers
Content-Type: application/jsonBody
{
"code": 200,
"result": [
{
"accuracy": 95.379539489746,
"beatmap_id": 1911308,
"beatmapset_id": 906786,
"fc": 549,
"max_combo": 549,
"mods": 88,
"pp": 935.63,
"rank": "SH",
"song_name": "Koda Kumi - Guess Who Is Back (TV Size) [Fiery's Extreme]",
"time": 1555972840,
"userid": 4350,
"username": "Legendre"
},
{
"accuracy": 98.03044128418,
"beatmap_id": 1199955,
"beatmapset_id": 327557,
"fc": 1544,
"max_combo": 1542,
"mods": 40,
"pp": 900.56,
"rank": "SH",
"song_name": "nameless - Milk Crown on Sonnetica [MiLk ShAke 9*]",
"time": 1508929514,
"userid": 4350,
"username": "Legendre"
},
{
"accuracy": 99.61205291748,
"beatmap_id": 1199955,
"beatmapset_id": 327557,
"fc": 1544,
"max_combo": 1525,
"mods": 8,
"pp": 867,
"rank": "A",
"song_name": "nameless - Milk Crown on Sonnetica [MiLk ShAke 9*]",
"time": 1557059608,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.240982055664,
"beatmap_id": 1892257,
"beatmapset_id": 906786,
"fc": 506,
"max_combo": 506,
"mods": 72,
"pp": 861.06,
"rank": "SH",
"song_name": "Koda Kumi - Guess Who Is Back (TV Size) [Extreme]",
"time": 1555869971,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.349594116211,
"beatmap_id": 1157868,
"beatmapset_id": 386619,
"fc": 1642,
"max_combo": 1642,
"mods": 0,
"pp": 857.87,
"rank": "S",
"song_name": "Asriel - Kegare Naki Yume [Epilogue]",
"time": 1559759037,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 96.91943359375,
"beatmap_id": 1690355,
"beatmapset_id": 805224,
"fc": 640,
"max_combo": 634,
"mods": 72,
"pp": 845.79,
"rank": "A",
"song_name": "Will Stetson - Super Driver [Fiery's Extreme]",
"time": 1559145779,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.213371276855,
"beatmap_id": 1095854,
"beatmapset_id": 516109,
"fc": 415,
"max_combo": 415,
"mods": 72,
"pp": 839.88,
"rank": "SH",
"song_name": "Aitsuki Nakuru - Monochrome Butterfly [Extra]",
"time": 1555033158,
"userid": 4246,
"username": "Hitomi"
},
{
"accuracy": 99.340660095215,
"beatmap_id": 1867520,
"beatmapset_id": 893614,
"fc": 1212,
"max_combo": 1212,
"mods": 72,
"pp": 834.72,
"rank": "SH",
"song_name": "u's - Snow halation [Snowfall]",
"time": 1563039106,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.593421936035,
"beatmap_id": 1872396,
"beatmapset_id": 896080,
"fc": 1682,
"max_combo": 1509,
"mods": 72,
"pp": 830.07,
"rank": "A",
"song_name": "Wakeshima Kanon - Tsukinami [Nostalgia]",
"time": 1553229513,
"userid": 4246,
"username": "Hitomi"
},
{
"accuracy": 99.733062744141,
"beatmap_id": 1762981,
"beatmapset_id": 842540,
"fc": 1458,
"max_combo": 1458,
"mods": 72,
"pp": 824.72,
"rank": "SH",
"song_name": "Duca - Kioku x Hajimari [Expert.]",
"time": 1559027969,
"userid": 4246,
"username": "Hitomi"
},
{
"accuracy": 98.882682800293,
"beatmap_id": 1642274,
"beatmapset_id": 781509,
"fc": 534,
"max_combo": 533,
"mods": 72,
"pp": 819.28,
"rank": "SH",
"song_name": "Vickeblanka - Black Rover (TV Size) [Extra]",
"time": 1555939056,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.623405456543,
"beatmap_id": 1095854,
"beatmapset_id": 516109,
"fc": 415,
"max_combo": 415,
"mods": 72,
"pp": 817.06,
"rank": "SH",
"song_name": "Aitsuki Nakuru - Monochrome Butterfly [Extra]",
"time": 1553348545,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.410087585449,
"beatmap_id": 1554502,
"beatmapset_id": 736560,
"fc": 1703,
"max_combo": 1703,
"mods": 72,
"pp": 815.32,
"rank": "SH",
"song_name": "Various Artists - Songs Compilation [Marathon]",
"time": 1557602129,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.347106933594,
"beatmap_id": 1955170,
"beatmapset_id": 744772,
"fc": 509,
"max_combo": 509,
"mods": 72,
"pp": 813.42,
"rank": "SH",
"song_name": "toby fox - Last Goodbye [Taeyang's Extra]",
"time": 1557422965,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.399398803711,
"beatmap_id": 1312156,
"beatmapset_id": 468614,
"fc": 421,
"max_combo": 421,
"mods": 72,
"pp": 800.42,
"rank": "SH",
"song_name": "Wan Ho-Kit, Lee Hon-Kam - Unknown Title [Let's show them Monstrata's powerful stance.]",
"time": 1559739277,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 97.591888427734,
"beatmap_id": 1857519,
"beatmapset_id": 873811,
"fc": 405,
"max_combo": 395,
"mods": 72,
"pp": 800.33,
"rank": "A",
"song_name": "dj TAKA - quaver [Nevo's Extra]",
"time": 1559738941,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.658615112305,
"beatmap_id": 1232440,
"beatmapset_id": 570938,
"fc": 708,
"max_combo": 708,
"mods": 72,
"pp": 797.67,
"rank": "SH",
"song_name": "LiSA - Catch the Moment -Radio Edit ver.- [Lami's Extra]",
"time": 1525328415,
"userid": 4246,
"username": "Hitomi"
},
{
"accuracy": 99.33829498291,
"beatmap_id": 1500990,
"beatmapset_id": 625669,
"fc": 532,
"max_combo": 532,
"mods": 72,
"pp": 794.41,
"rank": "SH",
"song_name": "96neko - Uso no Hibana [A r M i N's Ultra]",
"time": 1521857018,
"userid": 4246,
"username": "Hitomi"
},
{
"accuracy": 98.631103515625,
"beatmap_id": 1537817,
"beatmapset_id": 728405,
"fc": 1637,
"max_combo": 1637,
"mods": 72,
"pp": 793.38,
"rank": "SH",
"song_name": "ClariS - Kimi no shiranai monogatari [Serenity]",
"time": 1557600027,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.281135559082,
"beatmap_id": 1849580,
"beatmapset_id": 765497,
"fc": 2680,
"max_combo": 2680,
"mods": 0,
"pp": 787.62,
"rank": "S",
"song_name": "Foreground Eclipse - Songs Compilation [I Won't Say \"Farewell\"; Someday, We'll Meet Again]",
"time": 1551207869,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 97.686050415039,
"beatmap_id": 1983406,
"beatmapset_id": 931452,
"fc": 788,
"max_combo": 762,
"mods": 72,
"pp": 784.45,
"rank": "A",
"song_name": "HAG - Colorful [Fiery's Extreme]",
"time": 1556128917,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.876403808594,
"beatmap_id": 2058788,
"beatmapset_id": 983942,
"fc": 550,
"max_combo": 550,
"mods": 72,
"pp": 784.21,
"rank": "SH",
"song_name": "Oomori Seiko - JUSTadICE (TV Size) [Extreme]",
"time": 1565199733,
"userid": 1088,
"username": "D I V I N I T Y"
},
{
"accuracy": 99.038459777832,
"beatmap_id": 2022718,
"beatmapset_id": 966339,
"fc": 617,
"max_combo": 617,
"mods": 72,
"pp": 783.58,
"rank": "SH",
"song_name": "umu. - Ai no Sukima [Emotions]",
"time": 1559304067,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 97.940071105957,
"beatmap_id": 1570203,
"beatmapset_id": 744772,
"fc": 484,
"max_combo": 446,
"mods": 72,
"pp": 779.26,
"rank": "A",
"song_name": "toby fox - Last Goodbye [Determination]",
"time": 1559682080,
"userid": 1439,
"username": "akia"
},
{
"accuracy": 99.445983886719,
"beatmap_id": 2044366,
"beatmapset_id": 950289,
"fc": 519,
"max_combo": 519,
"mods": 72,
"pp": 777.79,
"rank": "SH",
"song_name": "Oomori Seiko - JUSTadICE (TV Size) [Lami's Extreme]",
"time": 1561916568,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 95.263160705566,
"beatmap_id": 2022204,
"beatmapset_id": 966062,
"fc": 542,
"max_combo": 541,
"mods": 72,
"pp": 776.53,
"rank": "SH",
"song_name": "The Cro-Magnons - Totsugeki Rock [Sotarks no Jutsu]",
"time": 1559304178,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 100,
"beatmap_id": 1271985,
"beatmapset_id": 602198,
"fc": 506,
"max_combo": 506,
"mods": 72,
"pp": 775.81,
"rank": "XH",
"song_name": "Tapimiru - Hakkensha wa Watashi (Anime Size) [Extra]",
"time": 1507866058,
"userid": 4246,
"username": "Hitomi"
},
{
"accuracy": 99.487182617188,
"beatmap_id": 1988911,
"beatmapset_id": 952498,
"fc": 511,
"max_combo": 511,
"mods": 72,
"pp": 774.94,
"rank": "SH",
"song_name": "Watarirouka Hashiritai - Kanpeki Gu~no ne (TV Size) [Taeyang's Perfect Partner!]",
"time": 1559478244,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 96.359222412109,
"beatmap_id": 1627148,
"beatmapset_id": 765778,
"fc": 261,
"max_combo": 261,
"mods": 72,
"pp": 773.31,
"rank": "SH",
"song_name": "Icon For Hire - Make a Move (Speed Up Ver.) [Endless Fear]",
"time": 1561667680,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.579582214355,
"beatmap_id": 1628503,
"beatmapset_id": 773330,
"fc": 730,
"max_combo": 730,
"mods": 72,
"pp": 767.1,
"rank": "SH",
"song_name": "Nanamori-chu * Goraku-bu - Happy Time wa Owaranai [AyyLazy's Expert]",
"time": 1555216279,
"userid": 4246,
"username": "Hitomi"
},
{
"accuracy": 98.603172302246,
"beatmap_id": 2014300,
"beatmapset_id": 961998,
"fc": 797,
"max_combo": 797,
"mods": 72,
"pp": 761.6,
"rank": "SH",
"song_name": "THE ORAL CIGARETTES - mist... [Extreme]",
"time": 1565200255,
"userid": 1088,
"username": "D I V I N I T Y"
},
{
"accuracy": 98.989898681641,
"beatmap_id": 1955170,
"beatmapset_id": 744772,
"fc": 509,
"max_combo": 458,
"mods": 72,
"pp": 760.68,
"rank": "A",
"song_name": "toby fox - Last Goodbye [Taeyang's Extra]",
"time": 1565200683,
"userid": 1088,
"username": "D I V I N I T Y"
},
{
"accuracy": 98.245613098145,
"beatmap_id": 2044362,
"beatmapset_id": 950289,
"fc": 528,
"max_combo": 528,
"mods": 72,
"pp": 760.04,
"rank": "SH",
"song_name": "Oomori Seiko - JUSTadICE (TV Size) [Extreme]",
"time": 1563038287,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.067596435547,
"beatmap_id": 1969946,
"beatmapset_id": 942642,
"fc": 411,
"max_combo": 411,
"mods": 72,
"pp": 758.5,
"rank": "SH",
"song_name": "Nanahira - Chikatto Chika Chika [Sotarks' 1+2 IQ]",
"time": 1559142887,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.312232971191,
"beatmap_id": 1763013,
"beatmapset_id": 842562,
"fc": 613,
"max_combo": 613,
"mods": 72,
"pp": 757.37,
"rank": "SH",
"song_name": "40mP feat. yuikonnu - Ame to Asphalt [Rain]",
"time": 1557598991,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.899887084961,
"beatmap_id": 1911308,
"beatmapset_id": 906786,
"fc": 549,
"max_combo": 549,
"mods": 72,
"pp": 751.54,
"rank": "SH",
"song_name": "Koda Kumi - Guess Who Is Back (TV Size) [Fiery's Extreme]",
"time": 1550956082,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.004096984863,
"beatmap_id": 1571309,
"beatmapset_id": 745312,
"fc": 802,
"max_combo": 753,
"mods": 72,
"pp": 751.46,
"rank": "A",
"song_name": "Ni-Sokkususu - Blade Dance [Special Kneesocks]",
"time": 1528594178,
"userid": 1439,
"username": "akia"
},
{
"accuracy": 98.899887084961,
"beatmap_id": 1911308,
"beatmapset_id": 906786,
"fc": 549,
"max_combo": 547,
"mods": 72,
"pp": 749.61,
"rank": "SH",
"song_name": "Koda Kumi - Guess Who Is Back (TV Size) [Fiery's Extreme]",
"time": 1554020186,
"userid": 1137,
"username": "Aki"
},
{
"accuracy": 99.180999755859,
"beatmap_id": 954692,
"beatmapset_id": 444335,
"fc": 574,
"max_combo": 574,
"mods": 72,
"pp": 748.85,
"rank": "SH",
"song_name": "HO-KAGO TEA TIME - Kira Kira Days [Shiawase!!]",
"time": 1556161383,
"userid": 4350,
"username": "Legendre"
},
{
"accuracy": 99.705665588379,
"beatmap_id": 1537566,
"beatmapset_id": 728276,
"fc": 2424,
"max_combo": 2424,
"mods": 16,
"pp": 748.76,
"rank": "S",
"song_name": "VINXIS - Sidetracked Day [THREE DIMENSIONS]",
"time": 1530036108,
"userid": 1003,
"username": "Haenes"
},
{
"accuracy": 97.611465454102,
"beatmap_id": 1612329,
"beatmapset_id": 735903,
"fc": 386,
"max_combo": 386,
"mods": 72,
"pp": 745.7,
"rank": "SH",
"song_name": "Hyper Potions - Time Trials [Effervescent Adventures]",
"time": 1558286498,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.907104492188,
"beatmap_id": 1068383,
"beatmapset_id": 501992,
"fc": 225,
"max_combo": 225,
"mods": 88,
"pp": 742,
"rank": "SH",
"song_name": "Drop - Granat [Expert]",
"time": 1546946842,
"userid": 1088,
"username": "D I V I N I T Y"
},
{
"accuracy": 99.499687194824,
"beatmap_id": 1451282,
"beatmapset_id": 685622,
"fc": 1367,
"max_combo": 1367,
"mods": 16,
"pp": 737.32,
"rank": "S",
"song_name": "BLUE ENCOUNT - HOPE [SURVIVOR]",
"time": 1556368266,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.311294555664,
"beatmap_id": 1843653,
"beatmapset_id": 873811,
"fc": 431,
"max_combo": 418,
"mods": 72,
"pp": 736.88,
"rank": "A",
"song_name": "dj TAKA - quaver [Fiery's Extra]",
"time": 1546947148,
"userid": 1088,
"username": "D I V I N I T Y"
},
{
"accuracy": 95.265151977539,
"beatmap_id": 1860433,
"beatmapset_id": 863227,
"fc": 569,
"max_combo": 542,
"mods": 72,
"pp": 736.87,
"rank": "A",
"song_name": "Brian The Sun - Lonely Go! (TV Size) [Fiery's Extreme]",
"time": 1558208690,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 99.119911193848,
"beatmap_id": 1917082,
"beatmapset_id": 917930,
"fc": 400,
"max_combo": 399,
"mods": 72,
"pp": 736.79,
"rank": "SH",
"song_name": "Fujiwara Chika (CV: Kohara Konomi) - Chikatto Chika Chika (TV Size) [Sotarks' 3 IQ]",
"time": 1557427999,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 96.634613037109,
"beatmap_id": 816600,
"beatmapset_id": 372851,
"fc": 550,
"max_combo": 549,
"mods": 72,
"pp": 735.12,
"rank": "SH",
"song_name": "Ni-Sokkususu - Blade Dance [Kneesocks]",
"time": 1555938094,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 92.424240112305,
"beatmap_id": 1969946,
"beatmapset_id": 942642,
"fc": 411,
"max_combo": 378,
"mods": 88,
"pp": 731,
"rank": "B",
"song_name": "Nanahira - Chikatto Chika Chika [Sotarks' 1+2 IQ]",
"time": 1565246366,
"userid": 7802,
"username": "FGSky"
},
{
"accuracy": 98.899887084961,
"beatmap_id": 1917082,
"beatmapset_id": 917930,
"fc": 400,
"max_combo": 400,
"mods": 72,
"pp": 729.44,
"rank": "SH",
"song_name": "Fujiwara Chika (CV: Kohara Konomi) - Chikatto Chika Chika (TV Size) [Sotarks' 3 IQ]",
"time": 1558902098,
"userid": 1088,
"username": "D I V I N I T Y"
},
{
"accuracy": 97.231094360352,
"beatmap_id": 1055147,
"beatmapset_id": 495332,
"fc": 453,
"max_combo": 453,
"mods": 72,
"pp": 725.16,
"rank": "SH",
"song_name": "Izumi Akazawa (CV. Madoka Yonezawa) - Responsibility Response [Slayed's Answer]",
"time": 1556135302,
"userid": 3079,
"username": "WhiteCat"
},
{
"accuracy": 98.666664123535,
"beatmap_id": 994495,
"beatmapset_id": 459149,
"fc": 244,
"max_combo": 244,
"mods": 72,
"pp": 722.96,
"rank": "SH",
"song_name": "Ayase Rie - Yuima-ru*World TVver. [Ultimate]",
"time": 1556127929,
"userid": 3079,
"username": "WhiteCat"
}
]
}