API reference

All endpoints live under https://api.temso.ai/v1, authenticate with an API key, and return the envelope format described in Getting started. The machine-readable spec is publicly available at /v1/openapi.json for SDK generation and validation tooling.

Project-scoped endpoints take a projectId path parameter — get yours from List Projects.

Raw data

One row per underlying record, for exports and your own aggregations:

• List AI Responses — prompt metadata and response previews
• Get Response Content — full markdown output and annotations for one response
• List Brand Mentions — every brand mention extracted from responses
• List Sources — every URL the models cited

Analytics

Pre-aggregated metrics, matching the views in the app:

• Get Brand Rankings — per-brand visibility, share of voice, mentions
• Get Share of Voice — daily mention counts per brand
• Get Visibility — your brand's daily visibility score

Configuration

• List Projects — projects available to your API key
• List Brands — your own brand and tracked competitors

Traffic ingestion

• Ingest Traffic Events — called automatically by the Cloudflare Worker that the Temso traffic integration generates during setup. You don't need it when consuming the API.

Model keys

The filter[models] parameter and model response fields use these keys: