BOINC Stats API

REST API for accessing BOINC cross-project statistics

Base URL: All endpoints are relative to the API base. Responses are JSON unless otherwise noted.

Global Statistics

GET /api/summary

Returns global statistics: total CPIDs, total credit, project count, country count.

GET /api/top-users

Returns top 20 contributors ranked by total credit.

Search

GET /api/search?q={query}

Search for users by CPID or username. Returns up to 20 results.

Example:

/api/search?q=john

User (CPID) Endpoints

GET /api/cpid/{cpid}

Get full user data including badges, stats, and project participation. CPID is a 32-character hexadecimal identifier.

Example:

/api/cpid/a1b2c3d4e5f67890123456789abcdef0
GET /api/cpid/{cpid}/badges

Get only badges earned by this CPID. Cached for 48 hours.

GET /api/cpid/{cpid}/stats

Get stats and project participation (without badges).

Project Endpoints

GET /api/projects

List all tracked BOINC projects with metadata.

GET /api/projects/{id}

Get details for a specific project including stats.

Example:

/api/projects/rosetta
GET /api/projects/{id}/users

Get top 50 users for a specific project.

GET /api/projects/{id}/teams

Get top 50 teams for a specific project.

Country Endpoints

GET /api/countries

List all countries with aggregated statistics (user count, total credit, rank).

GET /api/countries/{name}

Get country details with top 100 users. Country name uses underscores for spaces.

Example:

/api/countries/united_states

Data Types

CPID: A 32-character hexadecimal Cross-Project Identifier that links accounts across BOINC projects.

Credit: Floating point number representing BOINC credit earned. Large values may be in trillions.

Country names: Use underscores instead of spaces (e.g., united_states, czech_republic).

View JSON endpoint list | Back to Home