Constellation
An API for understanding online narratives, the posts that make them, and the actors who shape them
The Constellation API provides endpoints that let you analyze social posts, the accounts behind them, and the narratives connecting them. Using advanced AI, the API organizes raw social data into structured insights—showing what is being said, who is amplifying it, how it is propagating across platforms, and what potential risks it may pose to your organization.
The Posts endpoint returns post-level content such as text, author information, engagement metadata, and AI-generated enrichments including risk metrics and narrative identifiers. The Authors endpoint provides account-level context, including cohort membership and other actor-intelligence indicators. The Narratives endpoint returns clusters of related content, an AI-generated assessment of potential risk, a narrative summary, and a description of the narrative itself.
This API is ideal for customers who want to embed Constellation enrichments directly into their own products, dashboards, or analytical workflows.
All boolean and query searches are beta. They are intended to mirror a subset of the ElasticSearch DSL spec, but the current implementation is just an approximate. Any change to the functionality which makes it more-correctly implement that spec is considered non-breaking