Posts, metrics & timeseries
Core read endpoints: filtered post search, aggregate metrics, and time-bucketed series for volume/sentiment/engagement trends.
Sentiment, emotion & advanced analytics
Sentiment composition, emotion/intent breakdowns, controversy scoring, narrative clustering, causal impact, and forecasting.
Alerts, scorecard & reports
Create and manage alert rules, read active alerts, pull the executive scorecard, and generate reports.
Tenant administration
Manage data sources, entities, intents, users and invitations, branding, and tenant-level settings.
Platform administration
Superadmin-only endpoints for onboarding tenants, defining industry ontologies, and configuring aggregator connections.
Auth
Separate login endpoints for tenant users and platform admins.
API reference
The SocialPulse REST API's route groups, grouped by what they're for.
Posts, metrics & timeseries
Core read endpoints: filtered post search, aggregate metrics, and time-bucketed series for volume/sentiment/engagement trends — the same data the dashboard's charts render.
Sentiment, emotion & advanced analytics
Sentiment composition, emotion/intent breakdowns, controversy scoring, narrative clustering, causal impact, root-cause attribution, forecasting, cohort/segment retention, geography, and competitive benchmarking — the full analytics depth behind the dashboard's Analyze section.
Alerts, scorecard & reports
Create and manage alert rules, read active alerts, pull the executive scorecard, generate reports, and export data as CSV.
Tenant administration
Manage data sources, entities (brands/competitors/executives), intents, users and invitations, branding, and tenant-level settings — everything a Tenant Admin or Analyst configures for their own workspace.
Platform administration
Superadmin-only endpoints for onboarding tenants, defining industry ontologies, configuring aggregator connections, and reviewing prospect leads. Requires the Platform Admin role.
Auth
Separate login endpoints for tenant users and platform admins. See the Authentication guide for the full session/token model.