UnofficialArcaeaAPI

A slow Arcaea API for my own use.

Note

Some APIs will be inaccessible without a token. ¹

API Entry

• user/info

• user/best

• user/bests/session

• user/bests/result

• song/info

• song/list

• song/alias

• song/random

• assets/icon

• assets/char

• assets/song

• assets/aff

• assets/preview ²

• data/update

• data/theory

• data/challenge

• data/cert

• image/user/* ³

Error status

status	description
-1	invalid username or usercode
-2	invalid usercode
-3	user not found
-4	too many users
-5	invalid songname or songid
-6	invalid songid
-7	song not recorded
-8	too many records (*)
-9	invalid difficulty
-10	invalid recent/overflow number
-11	allocate an arc account failed
-12	clear friend failed
-13	add friend failed
-14	this song has no this level
-15	not played yet
-16	user got shadowbanned
-17	querying bests failed
-18	update service unavailable
-19	invalid partner
-20	file unavailable
-21	invalid range
-22	range of rating end smaller than its start
-23	potential is below the threshold of querying bests (10.0)
-24	need to update arcaea, please contact maintainer
-25	invalid version
-26	daily query quota exceeded
-27	illegal hash, please contact maintainer
-28	image server error
-29	invalid session info
-30	session expired
-31	session querying, queried charts: ${queriedCharts} (*)
-32	session waiting for account, account count: ${accountCount} (*)
-33	duplicate bests requests within 12 hours. cached session generated (*)
-34	invalid account
-233	internal error occurred

(*) means return additional data

Abnormal Example

• {apiurl}/botarcapi/song/alias?songid=gl

• Return data

{
    "status": -5,
    "message": "invalid songname or songid"
}

specially,

• {apiurl}/botarcapi/song/info?songname=lc

• Return data

{
  "status": -8,
  "message": "too many records",
  "content": {
    "songs": [
      "lostcivilization",
      "lastcelebration"
    ]
  }
}

Credits

• Special thanks to TheSnowfield for her BotArcAPI project and the extremely important assistance support in the development.

• Special thanks to tiger0132 for his ArcUpdAPI project and for giving me permission to use his code.

• Special thanks to InariAimu and Linwenxuan04 for Aff2Preview project.

• Special thanks to all those who contributed to this project or made suggestions.

License

Licensed under 616 SB License.

Footnotes

1. For functions of the API those are requiring token: Please send header with Authorization and the value Bearer token_here. ↩

2. The assets/preview API is provided by AffPreview. ↩

3. The image/user/bests/session API is not available. ↩