Methods

blogEntry.comments

Returns a list of comments to the specified blog entry.

Parameter Description
blogEntryId (Required) Id of the blog entry. It can be seen in blog entry URL. For example: /blog/entry/79

Return value: A list of Comment objects.

Example: http://codeforces.com/api/blogEntry.comments?blogEntryId=79

blogEntry.view

Returns blog entry.

Parameter Description
blogEntryId (Required) Id of the blog entry. It can be seen in blog entry URL. For example: /blog/entry/79

Return value: Returns a BlogEntry object in full version.

Example: http://codeforces.com/api/blogEntry.view?blogEntryId=79

contest.hacks

Returns list of hacks in the specified contests. Full information about hacks is available only after some time after the contest end. During the contest user can see only own hacks.

Parameter Description
contestId (Required) Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status

Return value: Returns a list of Hack objects.

Example: http://codeforces.com/api/contest.hacks?contestId=566

contest.list

Returns information about all available contests.

Parameter Description
gym Boolean. If true — than gym contests are returned. Otherwide, regular contests are returned.

Return value: Returns a list of Contest objects. If this method is called not anonymously, then all available contests for a calling user will be returned too, including mashups and private gyms.

Example: http://codeforces.com/api/contest.list?gym=true

contest.ratingChanges

Returns rating changes after the contest.

Parameter Description
contestId (Required) Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status

Return value: Returns a list of RatingChange objects.

Example: http://codeforces.com/api/contest.ratingChanges?contestId=566

contest.standings

Returns the description of the contest and the requested part of the standings.

Parameter Description
contestId (Required) Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status
from 1-based index of the standings row to start the ranklist.
count Number of standing rows to return.
handles Semicolon-separated list of handles. No more than 10000 handles is accepted.
room If specified, than only participants from this room will be shown in the result. If not — all the participants will be shown.
showUnofficial If true than all participants (virtual, out of competition) are shown. Otherwise, only official contestants are shown.

Return value: Returns object with three fields: "contest", "problems" and "rows". Field "contest" contains a Contest object. Field "problems" contains a list of Problem objects. Field "rows" contains a list of RanklistRow objects.

Example: http://codeforces.com/api/contest.standings?contestId=566&from=1&count=5&showUnofficial=true

contest.status

Returns submissions for specified contest. Optionally can return submissions of specified user.

Parameter Description
contestId (Required) Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status
handle Codeforces user handle.
from 1-based index of the first submission to return.
count Number of returned submissions.

Return value: Returns a list of Submission objects, sorted in decreasing order of submission id.

Example: http://codeforces.com/api/contest.status?contestId=566&from=1&count=10

problemset.problems

Returns all problems from problemset. Problems can be filtered by tags.

Parameter Description
tags Semicilon-separated list of tags.

Return value: Returns two lists. List of Problem objects and list of ProblemStatistics objects.

Example: http://codeforces.com/api/problemset.problems?tags=implementation

problemset.recentStatus

Returns recent submissions.

Parameter Description
count (Required) Number of submissions to return. Can be up to 1000.

Return value: Returns a list of Submission objects, sorted in decreasing order of submission id.

Example: http://codeforces.com/api/problemset.recentStatus?count=10

recentActions

Returns recent actions.

Parameter Description
maxCount (Required) Number of recent actions to return. Can be up to 100.

Return value: Returns a list of RecentAction objects.

Example: http://codeforces.com/api/recentActions?maxCount=30

user.blogEntries

Returns a list of all user's blog entries.

Parameter Description
handle (Required) Codeforces user handle.

Return value: A list of BlogEntry objects in short form.

Example: http://codeforces.com/api/user.blogEntries?handle=Fefer_Ivan

user.friends

Returns authorized user's friends. Using this method requires authorization.

Parameter Description
onlyOnline Boolean. If true — only online friends are returned. Otherwise, all friends are returned.

Return value: Returns a list of strings — users' handles.

Example: http://codeforces.com/api/user.friends?onlyOnline=true

user.info

Returns information about one or several users.

Parameter Description
handles (Required) Semicolon-separated list of handles. No more than 10000 handles is accepted.

Return value: Returns a list of User objects for requested handles.

Example: http://codeforces.com/api/user.info?handles=DmitriyH;Fefer_Ivan

user.ratedList

Returns the list users who have participated in at least one rated contest.

Parameter Description
activeOnly Boolean. If true then only users, who participated in rated contest during the last month are returned. Otherwise, all users with at least one rated contest are returned.

Return value: Returns a list of User objects, sorted in decreasing order of rating.

Example: http://codeforces.com/api/user.ratedList?activeOnly=true

user.rating

Returns rating history of the specified user.

Parameter Description
handle (Required) Codeforces user handle.

Return value: Returns a list of RatingChange objects for requested user.

Example: http://codeforces.com/api/user.rating?handle=Fefer_Ivan

user.status

Returns submissions of specified user.

Parameter Description
handle (Required) Codeforces user handle.
from 1-based index of the first submission to return.
count Number of returned submissions.

Return value: Returns a list of Submission objects, sorted in decreasing order of submission id.

Example: http://codeforces.com/api/user.status?handle=Fefer_Ivan&from=1&count=10