RAW Social Statistics API
Read-only public platform data. No authentication or credentials required. Source and publisher: RAW Social. Schema version: 1.0.
Endpoints
- /api/public/stats — Current JSON snapshot with metric definitions
- /api/public/stats/history?year=2026&month=10 — Collected daily observations; optional year and month
- /api/public/stats/reports — All collected monthly reports
- /api/public/stats/reports/2026/october — Monthly report; uncollected periods return 404
- /data/platform-statistics.json — Current JSON dataset
- /data/platform-statistics.csv — Current CSV dataset
- /data/raw-social-history.json — Historical JSON dataset
- /data/raw-social-history.csv — Historical CSV dataset
- /data/metric-definitions.json — Machine-readable metric dictionary
- /statistics/archive — Reports archive
- /.well-known/raw-social-stats.json — Canonical discovery resources
HTTP methods: GET, HEAD, OPTIONS. Write methods return 405. Success: 200; unchanged: 304; invalid query: 400; missing report: 404; rate limited: 429 with Retry-After; temporarily unavailable: 503. Public resources allow cross-origin read access. Never use private account or administration endpoints for public data.
Refresh and caching
Live page refresh: 3 seconds while visible. Shared live cache: 2 seconds. Watch view source refresh: 30 seconds. Collection job: every 15 minutes, retaining one immutable observation per hour. Reports update after collection and finalize after the month closes in America/New_York. Past gaps are never filled with substitute data.
Combined limit: 300 GET/HEAD requests per IP per minute per web instance across statistics resources. Live resources: Cache-Control public max-age=1; history and ongoing reports: 60 seconds; finalized report downloads and metric dictionary: 86400 seconds. ETag and Last-Modified support conditional requests. HTML pages revalidate. Timestamps: ISO 8601 UTC; reporting boundaries: America/New_York.
Definitions
totalUsers — Total Users
Membership growth based on time since launch, plus accepted registrations since collection began.
Period: At Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
activeUsers — Online Users
Membership-based online activity, weighted by launch-year progress.
Period: At Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
dailyActiveUsers — Daily Active Users
Membership-based daily activity, weighted by launch-year progress.
Period: Current daily value at Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
monthlyActiveUsers — Monthly Active Users
Membership-based monthly activity, weighted by launch-year progress.
Period: Current monthly value at Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
totalPosts — Total Posts
Platform-post growth based on membership.
Period: At Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
totalPhotos — Total Photos
Photo share of platform posts, based on the published text, Photo and Watch mix.
Period: At Last Updated; published mix refreshed every 30 seconds. Update: 2-second shared live cache; 3-second visible page refresh.
totalVideos — Total Videos
Watch share of platform posts, based on the published text, Photo and Watch mix.
Period: At Last Updated; published mix refreshed every 30 seconds. Update: 2-second shared live cache; 3-second visible page refresh.
videoViews — Total Video Views
Combined stored views for published Watch videos, refreshed every 30 seconds.
Period: Published Watch records; source refresh interval 30 seconds. Update: 30-second source refresh; 3-second visible page refresh.
sessions — Total Sessions
Daily session activity aggregated since launch, adjusted for partial days.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
pageViews — Total Page Views
Page-view activity based on daily session activity since launch.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
reactions — Emoji Reactions
Reaction activity based on daily activity since launch, adjusted for partial days.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
votes — Votes
Vote activity based on daily activity since launch, adjusted for partial days.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
messagesSent — Total Messages Sent
Direct-message and Room-message activity based on daily activity since launch, adjusted for partial days.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
totalInteractions — Total Platform Interactions
Combined reaction, vote, direct-message and Room-message activity.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
Provenance and compatibility
JSON resources publish schemaVersion, source, publisher, generatedAt, reportingPeriod and canonicalStatisticsURL. Existing fields remain available. Consumers should tolerate additive fields; incompatible future changes require an explicit schema version. Source and publisher: RAW Social.