Endpoints at a glance

Every Profound API endpoint, its key metrics/dimensions/filters, and what it’s for — one scannable page.

Orient yourself in 30 seconds. Each row is one endpoint; click through for the full parameter reference. For deeper context on conventions (dates, ordering, pagination), see Conventions & gotchas.

Organization & setup

Method	Path	Use it for
GET	/v1/org/categories	List every category your key can see.
GET	/v1/org/categories/{id}/assets	Assets in a category, with is_owned + domains.
GET	/v1/org/categories/{id}/topics	Configured topics for the category.
GET	/v1/org/categories/{id}/tags	Configured tags.
GET	/v1/org/categories/{id}/personas	Configured personas.
GET	/v1/org/regions	Regions enabled on your org.
GET	/v1/org/models	AI models (ChatGPT, Claude, etc.) enabled on your org.
GET	/v1/org/domains	Domains your org owns.
GET	/v1/org/personas	Personas enabled on your org.

Reports

Answer Engine Insights report endpoints are POST requests scoped by category_id and return the {info, data} shape. Visibility, citations, sentiment, and query-fanouts reports take category_id, start_date, end_date, and metrics, plus report-specific optional fields.

Traffic reports use a different shape: bots and referrals are scoped by domain rather than category_id. V2 FactCheck reports and V2 prompt answers are category-and-date scoped, but do not take a metrics field.

/v1/reports/visibility

How often your asset appears in AI answers.

Metrics	Dimensions	Common filters
visibility_score, share_of_voice, average_position, mentions_count, executions	date, asset_name, model, region, persona, topic, tag	asset_name, model_id, region_id, persona_id, topic_id, tag_id

Common recipes: Visibility Score (with delta), over time, leaderboard, compare competitors, segment by model/region/persona.

/v1/reports/citations

Which URLs and domains AI answers cite.

Metrics	Dimensions	Common filters
count, citation_share	date, root_domain, url, citation_category, model, region, persona	prompt_type (e.g. "visibility"), model_id, region_id, persona_id

Common recipes: Citation Share + delta, share + volume over time, rank by domain.

citation_share is per-AI-model averaged. count is the raw number. Sorting by one doesn’t track the other — pick the question you’re answering and sort on the matching metric.

/v1/reports/sentiment

How positively/negatively AI answers reference your asset.

Metrics	Dimensions	Common filters
positive, negative, occurrences	date, asset_name, theme, sentiment_type, topic, model, region, persona	asset_name, theme, topic_id, model_id, region_id, persona_id

Numbers from the current public sentiment endpoint will not match the Profound app’s headline value exactly. Sentiment v2 — which closes the gap — is releasing soon.

/v1/reports/query-fanouts

The query-fanout view (how prompts cascade across AI surfaces). Same {info, data} shape.

/v1/reports/referrals (and /v2/reports/referrals)

Human-referral traffic to your domains attributed back to AI answers.

/v1/reports/bots (and /v2/reports/bots)

AI crawler / bot traffic to your domains.

/v2/reports/factcheck and /v2/reports/factcheck/claims

FactCheck scores and inaccurate claims for a category. These endpoints take category_id, start_date, and end_date, but not metrics.

Answers (per-prompt data)

Method	Path	Use it for
POST	/v1/prompts/answers	Fetch raw AI answers for prompts in a category.
POST	/v2/prompts/answers	Fetch raw per-execution answer rows for a category.

Agents

Method	Path	Use it for
GET	/v1/agents	List configured agents.
GET	/v1/agents/{id}	Get one agent’s config.
POST	/v1/agents/{id}/runs	Start a new agent run.
GET	/v1/agents/{id}/runs/{run_id}	Poll a run’s status.

Prompts

Method	Path	Use it for
GET	/v1/org/categories/{id}/prompts	List prompts in a category.
POST	/v1/org/categories/{id}/prompts	Add a prompt.
PATCH	/v1/org/categories/{id}/prompts	Edit prompts.
PATCH	/v1/org/categories/{id}/prompts/status	Enable/disable prompts.

Content Optimization

Method	Path	Use it for
GET	/v1/content/{asset_id}/optimization	Optimization opportunities for an asset.
GET	/v1/content/{asset_id}/optimization/{content_id}	One optimization in detail.

---

For the canonical parameter reference (every operator, every field, required vs optional), see the REST API tab.