# Profound integration

> AI search visibility analytics — track brand mentions, citations, sentiment, and accuracy across AI answer engines, plus prompt management, content optimization, knowledge bases, projects, and agents.

- Authentication: apiKey

## Tools (88)

- **Accuracy Breakdown**: Factcheck accuracy broken down by citation, platform, topic, prompt, tag, region, persona, or theme, with citation share and accuracy per group.
- **Accuracy Citation Analysis**: Analyze how a specific cited URL affects factcheck accuracy in a category over a date range.
- **Accuracy Claim Breakdown**: Detailed breakdown of a single inaccurate-claim cluster.
- **Accuracy Claim Citations**: Citations backing the claims in an inaccurate-claim cluster, with search and sorting.
- **Accuracy Cluster Example Runs**: Example AI answer executions for a given inaccurate-claim cluster.
- **Accuracy Cluster Verification Pairs**: Claim/verification pairs for a given inaccurate-claim cluster.
- **Accuracy Factcheck Setup Status**: Whether factcheck/accuracy analysis is configured and running for a category.
- **Accuracy Inaccuracy Drivers**: Top drivers of inaccuracy about your brand in AI answers over the window.
- **Accuracy Inaccurate Clusters**: Clusters of inaccurate claims about your brand, optionally scoped to a theme and broken down by model.
- **Accuracy Inaccurate Themes**: Ranked themes where AI models make inaccurate claims about your brand, with response share over the window.
- **Accuracy Overview**: Factcheck accuracy overview for a category: headline accuracy score and trend over time, grouped by period or theme.
- **Accuracy Topic Ids**: List the topic IDs that have factcheck accuracy data in a category over a date range.
- **Accuracy Top Inaccurate Claims**: The most frequent inaccurate claims AI models make about your brand over the window.
- **Add Document**: Add a document to a knowledge base using JSON text or multipart file upload.
- **Add Folder**: Create an empty folder at the requested knowledge base path.
- **Archive Project**: Archive a project, retiring it from active tracking.
- **Create an agent**: Create a new draft agent owned by an organization. The agent starts as a draft; publish it separately once its graph is ready.
- **Create Project**: Create an AI-visibility project in a category, optionally seeded from a focus, topics, attachments, and generation context.
- **Create Project Task**: Add a task (recommended action) to a project.
- **Create prompts**: Create one or more prompts in a category. Topics and tags are auto-created if referenced by name. Use dry_run to preview without persisting.
- **Delete Document**: Delete an existing document from a knowledge base.
- **Delete Folder**: Delete a knowledge base folder. With recursive=false, non-empty folders return 409 and no contents are deleted.
- **Delete Project**: Delete a project by ID within a category.
- **Delete Project Task**: Delete a task from a project.
- **Get an agent**: Retrieve an agent and its schema details, choosing the published or draft version.
- **Get an agent run**: Retrieve the current status and result details for an agent run.
- **Get an agent's graph**: Retrieve an agent's full workflow graph (nodes and edges) in the canonical dialect that create and update accept.
- **Get a node type schema**: Retrieve the JSON schema for a single agent node type. Use schema_version as a cache key.
- **Get Answers**: Retrieve raw per-execution prompt answers (model responses) for a category, with mentions, citations, and filters. v1; prefer Query Answers V2.
- **Get Assets**: Get the organization assets, one row per (asset, organization) pair.
- **Get Bots Report V1**: Get bot/crawler traffic report from the daily aggregated materialized view: visits, citations, indexing, training events per bot.
- **Get Bots Report V2**: Get bot/crawler traffic report from the hourly aggregated materialized view (UTC): visits, citations, indexing, training per bot and bot type.
- **Get Categories**: Get the organization categories, one row per (category, organization) pair.
- **Get Category Assets**: Get the assets for a specific category.
- **Get Category Personas**: Get the personas for a specific category.
- **Get Category Regions**: Get the regions for a specific category.
- **Get Category Tags**: Get the tags for a specific category.
- **Get Category Topics**: Get the topics for a specific category.
- **Get Domains**: Get the organization domains.
- **Get Models**: Get the organization models.
- **Get Personas**: Get the organization personas, one row per (persona, organization) pair.
- **Get Project**: Retrieve a single project by ID within a category.
- **Get Project Generation Status**: Get the status of a single project generation run.
- **Get Project Status**: Get the current status of a project.
- **Get Project Task**: Retrieve a single task within a project.
- **Get Referrals Report V1**: Get referral traffic report from the daily aggregated materialized view. Efficient for large date ranges and high-traffic sites.
- **Get Referrals Report V2**: Get referral traffic report from the hourly aggregated materialized view (UTC), supporting hourly and calendar intervals.
- **Get Regions**: Get the organization regions.
- **List agents**: List agents available to your organization, filterable by publish status (published or draft), with cursor pagination.
- **List Knowledge Bases**: List knowledge bases accessible to the API key.
- **List node types**: List the node types available for building agents. The set is deterministic and safe to cache across sessions.
- **List organizations**: Return every organization the caller's API key grants access to. Use this to discover organization IDs before calling endpoints that accept an organization_id filter.
- **List Project Generations**: List project generation runs in a category, filterable by run status (queued, running, completed, failed).
- **List Projects**: List AI-visibility projects (action plans) in a category, filterable by status (suggested, tracked, retired).
- **List Project Tasks**: List the tasks (recommended actions) within a project.
- **List prompts**: Retrieve prompts in a category with optional filtering by type, topic, tag, region, platform, or persona. Supports cursor-based pagination.
- **Optimization Analysis**: Retrieve a single content optimization analysis for an asset: the AI-search optimization findings for one piece of content.
- **Optimization List**: List content optimization analyses for an asset: the pages analyzed for AI-search optimization, with pagination.
- **Publish an agent**: Publish an agent's latest draft as its live published version. A draft that cannot produce its declared input/output contract is rejected with 422.
- **Query Answers V2**: Retrieve raw per-execution AI answers for a category: model responses with mentions, citations, search queries, and sentiment claims, filterable and field-selectable.
- **Query Citations V2**: Query the citations report: which domains and pages AI answers cite, with count, citation share, and rank.
- **Query Factcheck Claims**: Query individual factcheck claims: the specific statements AI models make about your brand, with optional reasoning, evidence, and citation sources.
- **Query Factcheck Scores**: Query the factcheck accuracy report: headline accuracy score and per-dimension breakdown of how accurately AI models answer about your brand.
- **Query Fanouts V2**: Query the query-fanouts report: how a prompt fans out into sub-queries, with fanouts per execution, total fanouts, share, and query variations.
- **Query Sentiment V2**: Query the sentiment report: positive/negative sentiment and occurrence for a brand across AI models, with optional comparison window and theme/claim breakdown.
- **Query Visibility V2**: Query the visibility report: share of voice, visibility score, and average position for your brand across AI answer engines.
- **Query Web Search Results**: Get web search results for a given category: the search queries AI answer engines run, with count and per-prompt search share.
- **Run an agent**: Start a new run for an agent. Runs always execute the agent's live published version, so the agent must be published first.
- **Search Knowledge Base**: Search a knowledge base and return matching snippets or full pages.
- **Shopping All Items With Merchants**: All products in a shopping category with their surfacing merchants: per-item visibility, share of voice, average position, rating, prices, and merchant list.
- **Shopping Executions**: Raw shopping report executions for a category: per-execution rows filterable by analysis type (visibility, sentiment, accuracy).
- **Shopping Item Visibility**: Product-level visibility report for AI shopping answers: per-item visibility score, share of voice, average position, rating, and review count, with optional competitor comparison.
- **Shopping Merchant By Items**: Per-product merchant breakdown for AI shopping answers: which merchants surface each product, with merchant and product visibility, rank, prices, delivery options, and instant-checkout availability.
- **Shopping Merchant Distribution**: Merchant distribution report for AI shopping answers: offer count, product count, average rank, and share of offers per merchant.
- **Shopping Merchant Share**: Merchant share-of-voice report for AI shopping answers across target and owned assets, broken down by topic or prompt.
- **Shopping Merchant Visibility By Brand**: Merchant visibility broken down by brand for AI shopping answers: visibility score, share of voice, and average position per merchant/brand pair.
- **Shopping Product Merchant Urls**: Resolve the merchant URLs surfaced for one or more named products over a date range.
- **Shopping Triggered Prompts**: Prompts that triggered shopping answers in a category, aggregated over the requested window.
- **Shopping Triggered Topics**: Topics whose prompts triggered shopping answers in a category, aggregated over the requested window.
- **Shopping Trigger Rate**: Shopping trigger-rate report: how often prompts trigger a shopping answer, with total runs, shopping-triggered runs, and trigger-rate percentage.
- **Shopping Visibility**: Brand-level visibility report for AI shopping answers: share of voice, visibility score, and average position of owned and competitor brands in a shopping category.
- **Unarchive Project**: Unarchive a previously archived project, returning it to active tracking.
- **Update an agent**: Replace an agent's draft graph in place and re-validate it, iterating one draft rather than creating a new agent per change.
- **Update Document**: Overwrite a knowledge base document using JSON text or multipart file upload.
- **Update Project Task**: Update the fields of a task within a project. Only provided fields are changed.
- **Update Project Task Status**: Update a project task's status (not_started, in_progress, done, abandoned) with an optional note.
- **Update prompts**: Update one or more existing prompts. Only provided fields are changed; dimension fields replace the full set when provided.
- **Update prompt status**: Bulk-update the status of one or more prompts (active, disabled, or deleted). Prompts already in the target status are skipped.

## Triggers (1)

- **New AI Answer in Profound**: Triggers when Profound records a new AI answer execution in a category — the model response with its mentions and citations.

Connect Profound in General Input: https://www.generalinput.com/apps/profound