VRCSCORE

Developer access

VRCScore Data API

Read-only, key-controlled access to public VRCScore and cached VRChat profile data.

OpenAPI JSON

Authentication

Ask a VRCScore admin for an individual API key. Send it from a server or private script, never public browser code.

Authorization: Bearer vrcs_your_key_here

The X-API-Key header is also supported. Keys are scoped, independently revocable, rate limited, and shown only once when issued.

GET /api/v1

API index

Confirms the key, scopes, and current rate limit.

GET /api/v1/profiles

Profiles

Browse or search the cached VRCX/VRCNext and VRChat profile index. Supports q, after, and limit.

GET /api/v1/profiles/{usr_id}

Profile detail

Public cached metadata, VRCScore averages, verification state, and review totals.

GET /api/v1/profiles/{usr_id}/reviews

Profile reviews

Paginated public reviews received by one VRChat profile.

GET /api/v1/reviews

Reviews

Public reviews with target, reviewer, before, and limit filters.

GET /api/v1/reviews/{id}

Review detail

One public review. Anonymous reviewer identities are never returned.

GET /api/v1/stats/overview

Overview

Profile, review, reviewer, and reviewed-profile totals.

GET /api/v1/stats/leaderboards

Leaderboards

Most active reviewers, most reviewed profiles, highest scores, and lowest scores.

GET /api/v1/announcements

Announcements

Current public VRCScore announcements.

Example

curl "https://vrcscore.com/api/v1/profiles?q=bings&limit=10" \
  -H "Authorization: Bearer vrcs_your_key_here"

Collection responses include pagination.nextCursor. Pass that value as after for profiles or before for reviews.

Privacy boundary

The API excludes OAuth credentials, VRChat session cookies, bridge keys, private linked accounts, moderation-only data, and anonymous reviewer identities.