SocialPulse

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.