API server application and scrapers are written in Scala.

sbt assembly

To run all the tests, you need to prepare PostgreSQL with a test database.

sbt test

After running the build command, you will have target/scala-*/atcoder-problems-assembly-*.jar. It is a .jar package, which is executable of Java. You can run the API server by the following command with a configuration files env.json. Please make sure you already have the PostgreSQL environment with required databases before running. A sample of the config file and the schema file of the database are in atcoder-problems-backend/src/test/resources.

java -jar target/scala-*/atcoder-problems-*.jar env.json

Frontend web application is written in TypeScript.

# install node modules
npm install

# generate js file and source map
webpack

# generate minified js file
npm run build

npm test

#build Dockerfile
docker build ./

#run docker image
docker run -h spam -i -t {image_name} /bin/bash

#after you entered shell
#please start db server
service postgresql start

You can login db server with this user:name="kenkoooo",password="pass",dbname="test". This docker image has everything you need for building and testing this repository(including prepared db server). You can use git to get data and start testing.

Please use API politely. Especially, please ensure using cache and adding delay if you develop a bot.

APIは行儀良く利用してください。 特にbotを開発している場合は、ETagを用いたキャッシュを利用し、連続して呼び出す際はある程度 (例えば1秒) の遅延をはさむようにしてください。 1日に数万回以上のリクエストをしたい場合は事前に相談してください。

ブラウザ上からJavaScriptで直接利用している場合はあまり気にする必要はありません。 キャッシュはブラウザがよしなにやってくれますし、呼び出し回数もたいてい多くならないためです。 botの場合も1日に1000回以下程度のリクエストであればたいした負荷にはならないので心配する必要はありません。

• Contests Information
  • https://kenkoooo.com/atcoder/resources/contests.json
• Problems Information
  • https://kenkoooo.com/atcoder/resources/problems.json
• Detailed Problems Information
  • https://kenkoooo.com/atcoder/resources/merged-problems.json

(The API info/* are deprecated. Please use new API.)

• Accepted Count
  • https://kenkoooo.com/atcoder/resources/ac.json
• Shortest Code Count
  • https://kenkoooo.com/atcoder/resources/short.json
• Fastest Code Count
  • https://kenkoooo.com/atcoder/resources/fast.json
• First Accepted Count
  • https://kenkoooo.com/atcoder/resources/first.json
• Rated Point Sum
  • https://kenkoooo.com/atcoder/resources/sums.json
• Accepted Count for each langages
  • https://kenkoooo.com/atcoder/resources/lang.json

(The API info/* are deprecated. Please use new API.)

• https://kenkoooo.com/atcoder/atcoder-api/v2/user_info?user=kenkoooo

• https://kenkoooo.com/atcoder/atcoder-api/results?user=wata

(The API results?user=wata&rivals=iwiwi,chokudai is obsoleted since it's difficult to cache. Please call above API 3 times as results?user=wata, results?user=iwiwi and results?user=chokudai.)

• [SQL version] https://s3-ap-northeast-1.amazonaws.com/kenkoooo/atcoder.sql
• [CSV version] https://s3-ap-northeast-1.amazonaws.com/kenkoooo/atcoder_submissions.csv

You can download whole data, which are crawled by the official crawler.