Application Program Interface

Information related to users, problems, submissions, sources. etc for your applications

 New APIs will be provided in the first half of 2017. Document for the new API is partially available here. Please contact us if you are planing to develop services based on the API.

Specification of the service

The API provides information for users, problems, submission, etc. in XML format. Please note that, the API is under construction. So, the specification may change without notice.

User Search API
Problem Search API
Problem List Search API
All User List Search API
Solved Record Search API
Status Log Search API
Judge Detail Search API
Problem Category Search API
Source Search API

Thread Search API
Message Search API
Thread Search from problem ID API
Recent Message Search API

Contest List Search API
Contest Info. Search API
Contest Standing Search API
Contest Problem Search API
Contest Status Log Search API
 

User Search API

Provides detailed information of the specific user.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/user

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/user?id=shioshiota

Search Query
 
ParameterDescriptionTypeRequiredExample
idUser ID.stringyesshioshiota
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
idUser ID.string1shioshiota
nameUser Name.string1Tetsuya Shiota
affiliationAffiliation of the user.string1University of Aizu
registerdateRegistered date.long integer11245139751485
lastsubmitdateLast submitted date.long integer11330502486334
statusUser's status1
  - submission The number of submissions.integer1 2166
  - solved The number of solved problems.integer1 600
  - accepted The number of accepted submissions.integer1 713
  - wronganswer The number of wrong answers.integer1 939
  - timelimit The number of time limit exceeding.integer1 302
  - memorylimit The number of memory limit exceeding.integer1 19
  - outputlimit The number of output limit exceeding.integer1 0
  - runtimeerror The number of runtime errors.integer1 127
  - compileerror The number of compile errors.integer1 66
solved_listList of solved problems 1
  - problem Solved problems. The number of solved problems.
    - id Problem ID.string 10000
    - submissiondateDate of submission. long integer1 1275113738987
    - languageProgramming Language. string1 C++
    - cputimeCPU Time (sentisecond).integer1 0
    - memoryMemory usage (Kbyte). integer1 0
    - code_sizeCode size (byte). integer 1191
 

Problem Search API

Provides detailed information of the specific problem.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/problem

Example 1

http://judge.u-aizu.ac.jp/onlinejudge/webservice/problem?id=0002

Example 2

http://judge.u-aizu.ac.jp/onlinejudge/webservice/problem?id=0002&status=false

Search Query
 
ParameterDescriptionTypeRequiredExample
idProblem ID.stringyes0002
statusFlag for showing status.stringnofalse
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
idProblem ID.string10002
nameProblem Name.string1Binary Tree Intersection And Union
availableJudge Type (0:Not available, 1:Judge, 2:Judge allowing precision error, 3:Judge with Validator, 4:Reactive judge).integer11
problemtimelimitTime limit assigned to the problem (second).integer11
problemmemorylimitMemory limit assigned to the problem (Kbyte).integer132768
statusProblem's status1
  - submission The number of submissions.integer1 59
  - accepted The number of accepted submissions.integer1 37
  - wronganswer The number of wrong answers.integer1 14
  - timelimit The number of time limit exceeding.integer1 4
  - memorylimit The number of memory limit exceeding.integer1 0
  - outputlimit The number of output limit exceeding.integer1 0
  - runtimeerror The number of runtime errors.integer1 4
solved_listList of users who solved the problem 1
  - user The user who solved the problem. n
    - id User ID.string 1solver
    - submissiondateDate of submission. long integer1 1105194277849
    - languageProgramming Language. string1 C++
    - cputimeCPU Time (sentisecond).integer1 0
    - memoryMemory usage (Kbyte). integer1 0
    - code_sizeCode size (byte). integer 12158
 

Problem List Search API

Provides a list of problems in the specific volume.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/problem_list

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/problem_list?volume=10

Search Query
 
ParameterDescriptionTypeRequiredExample
volumeVolume No.integeryes10
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
problem_listList of problems in the specified volume 1
  - problem Problem. The number of problems in the specified volume.
    - id Problem ID.string 11000
    - nameName of the problem. string1 A + B Problem
    - problemtimelimitTime limit assigned to the problem (second).integer11
    - problemmemorylimitMemory limit assigned to the problem (Kbyte).integer132768
 

All User List (Rank List) Search API

Provides a list of users meeting specified criteria.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/user_list

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/user_list?affiliation=aizu&solved_min=20&solved_max=200

Search Query
 
ParameterDescriptionTypeRequiredExample
criteriaCriteria for sotring. 0 = order by solved, 1 = order by rating.integerno (default: 0)0
affiliationA substring in the affiliation.stringnoaizu
solved_min The service returns a list of users who solved at least solved_min problemsintegerno20
solved_max The service returns a list of users who solved at most solved_max problemsintegerno200
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
user_listList of users 1
  - user The user. n
    - rank The rank based on the specified criteria.integer 11
    - id User ID.string 1nob
    - name Name of the user.string 1Nobuyuki Wachi
    - affiliation Affiliation of the user.string 1University of Aizu
    - solved The number of solved problems.integer 1116
    - rating Rating of the user.float 1414.047
 

Solved Record Search API

Provides a list of accepted submission records meeting specified criteria.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/solved_record

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/solved_record?user_id=solver

Search Query
 
ParameterDescriptionTypeRequiredExample
user_idUser ID.string user_id or problem_id should be specified.solver
problem_idProblem ID.string user_id or problem_id should be specified.1000
languageProgramming language.string noJAVA
date_beginThe service returns records after date_begin.long integerno1244400000000
date_endThe service returns records before date_end.long integer no1260000000000
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
solved_record_listList of solved records 1
  - solved The solved record. n
    - run_id Run ID.integer 110873
    - user_id User ID.string 1aizu
    - problem_id Problem ID.string 10000
    - date Date of submission.long integer 11241341589469
    - language Programming language.string 1C++
    - cputime CPU Time (sentisecond).integer 10
    - memory Memory usage (Kbyte).integer 10
    - code_size Code size (byte).integer 1110
 

Status Log Search API

Provides a list of submission records meeting specified criteria.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/status_log

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/status_log?user_id=solver

Search Query
 
ParameterDescriptionTypeRequiredExample
user_idUser ID.string nosolver
problem_idProblem ID.string no1000
startStart position.integerno0
limitThe number of records. (1 ≤ limit ≤ 100)integer no5
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
status_listList of status records 1
  - status The status record. n
    - run_id Run ID.integer 110873
    - user_id User ID.string 1aizu
    - problem_id Problem ID.string 10000
    - submission_date Date of submission.long integer 11241341589469
    - status Judge status.string 1Accepted
    - language Programming language.string 1C++
    - cputime CPU Time (sentisecond).integer 10
    - memory Memory usage (Kbyte).integer 10
    - code_size Code size (byte).integer 1110
 

Judge Detail Search API

Provides details of a judge result.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/judge

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/judge?id=328644

Search Query
 
ParameterDescriptionTypeRequiredExample
idRun ID.string yes349776
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
judge_idJudge ID (= Run ID)string 1349776
judge_type_code Judge Type Code int 1 1
judge_typeJudge Type:
Judge
Judge allowing precision error
Judge with validator
Reactive judge
Not available
string 1 Judge
submissiondate Time the program submitedlong 1 1330306881952
judgedate Time the judge finishedlong 1 1330306883063
languageLanguage string 1 C++
cuptimeCPU timeint 10
memoryMemory usage int 1 0
code_size Code size int 1159
statusJudge result code
0:Compile Error
1:Wrong Answer
2:Time Limit Exceeded
3:Memory Limit Exceeded
4:Accepted
6:Output Limit Exceeded
7:Runtime Error
8:Presentation Error
int 10
accuracy(The number of accepted cases) / (The number of test cases) string 10/1
problem_id Problem ID string 11000
problem_title Problem Title string 1A + B Problem
submissions The number of submissions for the problemint 11350
accepted The number of accepted submissions for the problemint 1997
user_id User ID string 1judge
user_name User Namestring 1Judge Team
affiliationAffiliationstring 1University of Aizu
 

Problem Category Search API

Provides categories and the corresponding scores of all problems or the specific problem. Please note that, the scores have been assigned subjectively and there are problems which we have not assigned the score yet.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/problem_category

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/problem_category?id=1301

Search Query
 
ParameterDescriptionTypeRequiredExample
idProblem ID.stringno1301
categoryCategory Name.stringnogeometry
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
problem_categoryList of problems. 1
  - problem Problem. n
    - idProblem ID.string11301
    - categoryCategory Name.string1geometry
    - scoreScore assigned to the problem.float13.50
 

Source Search API

Provides detailed information of the source of a specific problem.

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/source

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/source?id=1054

Search Query
 
ParameterDescriptionTypeRequiredExample
idProblem ID.stringyes1054
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
idProblem ID.string11054
titleTitle of the source.string1University of Aizu Programming Contest 2010
subtitleSubtitle of the source.string1
placeThe place the corresponding contest.string1Aizu-Wakamatsu, Japan
abbrAbbreviation of the title.string1UAPC 2010
author1Author of the problem.string1Takashi Tayama
author2Second author of the problem.string1
yearYearstring12010
monthMonthstring105
dayDaystring129
noteSpecial notesstring1
urlURLstring1http://judge.u-aizu.ac.jp/onlinejudge
judgeJudgestring1
 

Contest List Search API

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_list

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_list

Search Query
 
ParameterDescriptionTypeRequiredExample
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
 

Contest Info Search API

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_info

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_info?id=UAPC2011

Search Query
 
ParameterDescriptionTypeRequiredExample
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
 

Contest Standing Search API

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_standing

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_standing?id=RUPC2011

Search Query
 
ParameterDescriptionTypeRequiredExample
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
 

Contest Problem Search API

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_problem

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_problem?id=RUPC2011

Search Query
 
ParameterDescriptionTypeRequiredExample
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
 

Contest Status Log Search API

URL

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_status_log

Example

http://judge.u-aizu.ac.jp/onlinejudge/webservice/contest_status_log?id=UAPC2011

Search Query
 
ParameterDescriptionTypeRequiredExample
 
Response Fields
 
FieldDescriptionTypeFrequencyExample
 

Thread Search API

It can obtain information of thread to input thread ID.

URL

http://rose.u-aizu.ac.jp/aojbbs/webservice/thread/<threadId>.xml
http://rose.u-aizu.ac.jp/aojbbs/webservice/thread/<threadId>.json

Example

http://rose.u-aizu.ac.jp/aojbbs/webservice/thread/1.xml
http://rose.u-aizu.ac.jp/aojbbs/webservice/thread/1.json

Search Query
 
Parameter Description Type Required Example
id Thread ID. long integer no 7
 
Response Fields
 
Field Description Type Example
id Thread ID long integer 7
name Thread title string Thread Title
problem_id aoj problem number string 0001
user_id aoj ID string shioshiota
attribute_id thread attribute long integer 1
    - 1 Question long integer
    - 2 Discussion long integer
    - 3 Trouble long integer
    - 4 Announce long integer
update_time thread update time Date 2012-04-23 10:05:34.0
 

GET Recent Thread API

Display XML of the number of thread recently.

URL

http://rose.u-aizu.ac.jp/aojbbs/webservice/recent/thread/<number>

Example

http://rose.u-aizu.ac.jp/aojbbs/webservice/recent/thread/5.xml

Search Query
 
Parameter Description Type Required Example
number Number of thread. integer no 10
 
Response Fields
 
Field Description Type Example
problem_id aoj problem number string 0001
user_id aoj ID string shioshiota
attribute_id thread attribute long integer 1
    - 1 Question long integer
    - 2 Discussion long integer
    - 3 Trouble long integer
    - 4 Announce long integer
update_time thread update time Date 2012-04-23 10:05:34.0
 

Message Search API

it can obtain information of message to input message ID.

URL

http://rose.u-aizu.ac.jp/aojbbs/webservice/message/<messageId>.xml
http://rose.u-aizu.ac.jp/aojbbs/webservice/message/<messageId>.json

Example

http://rose.u-aizu.ac.jp/aojbbs/webservice/message/5.xml

Search Query
 
Parameter Description Type Required Example
id Message ID. long integer no 45
 
Response Fields
 
Field Description Type Example
id message ID long integer 37
thread_id thread ID in message long integer 14
problem_id problem ID in message string 0067
attribute_id thread ID in message long integer 1
    - 1 Question long integer
    - 2 Discussion long integer
    - 3 Trouble long integer
    - 4 Announce long integer
user_id aoj ID string shioshiota
content contents of message string I have a trouble.
url reference URL(non-functional) string http://
update_time message submit time time Date 2012-04-23 10:05:34.0
 

Thread Seach from problem ID API

It can obtain information of thread to input problem ID.

URL

http://rose.u-aizu.ac.jp/aojbbs/webservice/thread/problem/<problemId>.xml
http://rose.u-aizu.ac.jp/aojbbs/webservice/thread/problem/<problemId>.json

Example

http://rose.u-aizu.ac.jp/aojbbs/webservice/problem/0000.xml
http://rose.u-aizu.ac.jp/aojbbs/webservice/problem/0000.json

Search Query
 
Parameter Description Type Required Example
problem_id Problem ID. long integer no 1
 
Response Fields
 
Field Description Type Example
id Thread ID long integer 87
name Thread title string Thread Title
problem_id aoj problem number long integer 0001
user_id aoj ID string shioshiota
attribute_id thread attribute long integer 1
    - 1 Question long integer
    - 2 Discussion long integer
    - 3 Trouble long integer
    - 4 Announce long integer
update_time thread update time Date 2012-04-23 10:05:34.0
 

Message Search from Thread ID API

It can obtain information of message to input thread ID.

URL

http://rose.u-aizu.ac.jp/aojbbs/webservice/message/thread/<threadId>.xml
http://rose.u-aizu.ac.jp/aojbbs/webservice/message/thread/<threadId>.json

Example

http://rose.u-aizu.ac.jp/aojbbs/webservice/message/thread/1.xml
http://rose.u-aizu.ac.jp/aojbbs/webservice/message/thread/1.json

Search Query
 
Parameter Description Type Required Example
id Thread ID. long integer no 1
 
Response Fields
 
Field Description Type Example
id message ID long integer 37
thread_id thread ID in message long integer 14
problem_id problem ID in message string 0067
attribute_id thread ID in message long integer 1
    - 1 Question long integer
    - 2 Discussion long integer
    - 3 Trouble long integer
    - 4 Announce long integer
user_id aoj ID string shioshiota
content contents of message string I have a trouble.
url reference URL(non-functional) string http://
update_time message submit time time Date 2012-04-23 10:05:34.0
 

GET Recent Message API

Display XML of the number of message recently.

URL

http://rose.u-aizu.ac.jp/aojbbs/webservice/recent/message/<messageId>.xml

Example

http://rose.u-aizu.ac.jp/aojbbs/webservice/recent/message/5.xml

Search Query
 
Parameter Description Type Required Example
id Message ID. integer no 45
 
Response Fields
 
Field Description Type Example
id message ID long integer 37
thread_id thread ID in message long integer 14
problem_id problem ID in message string 0067
attribute_id thread ID in message long integer 1
    - 1 Question long integer
    - 2 Discussion long integer
    - 3 Trouble long integer
    - 4 Announce long integer
user_id aoj ID string shioshiota
content contents of message string I have a trouble.
url reference URL(non-functional) string http://
update_time message submit time time Date 2012-04-23 10:05:34.0