# 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. ## Servers ``` https://api-prd.infra-prod.blackbird.ai/v1 ``` ## Download OpenAPI description [Constellation](https://docs.blackbird.ai/_bundle/constellation.yaml) ## Project ### find_projects - [GET /projects](https://docs.blackbird.ai/constellation/project/find_projects.md) ### find_projects_by_id - [GET /projects/{id}](https://docs.blackbird.ai/constellation/project/find_projects_by_id.md) ## Posts ### Search for posts - [POST /posts/-/search](https://docs.blackbird.ai/constellation/posts/postsearch.md): The Posts endpoint allows you to fetch social posts that have been processed and enriched by Constellation. Each post includes its original content—such as text, author information, and engagement data—along with enrichments that provide deeper analytical context. ## Narratives ### Search for narratives - [POST /narratives/-/search](https://docs.blackbird.ai/constellation/narratives/narrativessearch.md): The Narratives endpoint allows you to fetch clusters of related content that Constellation has grouped into coherent narratives. Each narrative includes an AI-generated summary, a description, and an assessment of the claim.