Data Center

RAW Social Statistics API

Read-only public platform data. No authentication or credentials required. Source and publisher: RAW Social. Schema version: 1.0.

Endpoints

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.