RAW Social Statistics API
Read-only public aggregate platform counters. 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
The site's member counter: 4,000,000,000 × elapsed launch-year fraction, capped at one year, plus accepted new registrations since collection began.
Period: At Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
activeUsers — Online Users
The site's online counter: member counter × (25% + 75% × launch-year fraction), rounded down.
Period: At Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
dailyActiveUsers — Daily Active Users
The site's daily activity counter: member counter × (50% + 50% × launch-year fraction), rounded down.
Period: Current daily counter at Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
monthlyActiveUsers — Monthly Active Users
The site's monthly activity counter: member counter × (75% + 25% × launch-year fraction), rounded down.
Period: Current monthly counter at Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
totalPosts — Total Posts
The site's platform-post counter: member counter × 1.1, rounded down.
Period: At Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
totalPhotos — Total Photos
Platform photo counter: Total Posts × the Photo share of published text, Photo and Watch posts. Shares refresh every 30 seconds. Whole-number rounding keeps the post-type breakdown consistent with Total Posts.
Period: At Last Updated; published mix refreshed every 30 seconds. Update: 2-second shared live cache; 3-second visible page refresh.
totalVideos — Total Videos
Platform video counter: Total Posts × the Watch share of published text, Photo and Watch posts. Shares refresh every 30 seconds. Whole-number rounding keeps the post-type breakdown consistent with Total Posts.
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 Watch view counters for published 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
Sum the site's daily session counters: 1.6 × the daily activity counter at each observed date's midpoint, prorated for partial dates and rounded down.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
pageViews — Total Page Views
Sum the site's daily page-view counters: 4.2 × each date's session counter, rounded down.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
reactions — Emoji Reactions
Sum the site's daily reaction counters: 2.4 × each date's daily activity counter, prorated for the observed part of the date and rounded down.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
votes — Votes
Sum the site's daily vote counters: 0.65 × each date's daily activity counter, prorated for partial dates and rounded down.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
messagesSent — Total Messages Sent
Sum the site's daily direct-message and Room-message counters: daily activity × 0.4 and × 0.18 respectively, with partial-date proration and rounding.
Period: Since platform launch through Last Updated. Update: 2-second shared live cache; 3-second visible page refresh.
totalInteractions — Total Platform Interactions
Combined platform reaction, vote, direct-message and Room-message counters.
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.