> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/profound.md).

# Profound

Profound measures brand visibility and sentiment across AI search engines like ChatGPT, Perplexity, Claude, and Gemini.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication |
| --------- | -------------- |
| Profound  | API Key        |

### Profound

Connect to Profound to query brand visibility and sentiment analytics across AI search engines.

#### Set up in Profound

1. Sign in to your Profound account at tryprofound.com.
2. Open your account settings and find the API section to generate an API key (create one if you don't have it yet).
3. Copy the API key and treat it like a password.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Profound**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                                                                                                                                                                                                         |
| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key       | Yes      | Your Profound API key. Create one at Settings → API Keys in the Profound dashboard. Keys cannot be retrieved after creation, so copy it before closing the confirmation dialog. [Provider instructions](https://app.tryprofound.com). |

**Provider documentation:** [Setup reference](https://docs.tryprofound.com/sdks/overview).

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **Profound** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### Get Brand Visibility

Get visibility metrics from Profound for a brand or category you're tracking - share of voice, mentions, visibility score, and more - over any date range.

#### Inputs

| Field             | Type                      | Required | Description                                                                                                                                                                                                                                                                                                                       |
| ----------------- | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Brand or Category | string                    | Yes      | The brand or category you want to query in Profound. Enter a brand name (like 'StackAI') to see just that brand's metrics, or a category name to see every brand in the category. Only brands you've added as assets in your Profound account will return data - if a brand isn't there yet, add it at app.tryprofound.com first. |
| Start Date        | string                    | Yes      | Start of your date range (YYYY-MM-DD). Profound treats dates without a timezone as EST.                                                                                                                                                                                                                                           |
| End Date          | string                    | Yes      | End of your date range (YYYY-MM-DD, inclusive). Must be before today. Profound treats dates without a timezone as EST.                                                                                                                                                                                                            |
| Metrics           | multiple\_select (string) | Yes      | Pick one or more metrics you want back. Available values: Share of Voice, Mentions, Visibility Score, Total Executions, Average Position.                                                                                                                                                                                         |
| Group By          | multiple\_select (string) | No       | Optional - pick attributes to break your results down by. Leave empty for a single aggregated row. Available values: Date, Region, AI Model, Topic, Topic ID, Asset, Asset ID, Prompt, Prompt ID, Tag, Persona.                                                                                                                   |
| Time Interval     | select (string)           | No       | How your time-series results are bucketed. Only takes effect when you include 'Date' in Group By. Available values: Hour, Day, Week, Month, Quarter, Year, Relative Week. Default: day.                                                                                                                                           |
| Max Results       | integer                   | No       | Maximum rows you want back. Up to 50,000. Minimum: 1. Maximum: 50000. Default: 10000.                                                                                                                                                                                                                                             |

#### Outputs

| Field         | Type        | Description                                                                                           |
| ------------- | ----------- | ----------------------------------------------------------------------------------------------------- |
| Rows          | dict\_array | Your results - one entry per group, with metrics and dimensions keyed by name.                        |
| Total Rows    | integer     | How many rows Profound has in total for your query - may exceed what was returned if you set a limit. |
| Rows Returned | integer     | How many rows were actually returned to you.                                                          |

### Get Brand Sentiment

Get sentiment data from Profound for a brand or category you're tracking - positive mentions, negative mentions, and total occurrences - over any date range.

#### Inputs

| Field             | Type                      | Required | Description                                                                                                                                                                                                                                                                                                                         |
| ----------------- | ------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Brand or Category | string                    | Yes      | The brand or category you want to query in Profound. Enter a brand name (like 'StackAI') to see just that brand's sentiment, or a category name to see every brand in the category. Only brands you've added as assets in your Profound account will return data - if a brand isn't there yet, add it at app.tryprofound.com first. |
| Start Date        | string                    | Yes      | Start of your date range (YYYY-MM-DD). Profound treats dates without a timezone as EST.                                                                                                                                                                                                                                             |
| End Date          | string                    | Yes      | End of your date range (YYYY-MM-DD, inclusive). Must be before today. Profound treats dates without a timezone as EST.                                                                                                                                                                                                              |
| Metrics           | multiple\_select (string) | Yes      | Pick one or more metrics you want back. Available values: Positive Mentions, Negative Mentions, Total Occurrences.                                                                                                                                                                                                                  |
| Group By          | multiple\_select (string) | No       | Optional - pick attributes to break your results down by. Leave empty for a single aggregated row. Available values: Theme, Date, Region, AI Model, Topic, Topic ID, Asset, Asset ID, Prompt, Prompt ID, Tag, Sentiment Type, Persona.                                                                                              |
| Time Interval     | select (string)           | No       | How your time-series results are bucketed. Only takes effect when you include 'Date' in Group By. Available values: Hour, Day, Week, Month, Quarter, Year, Relative Week. Default: day.                                                                                                                                             |
| Max Results       | integer                   | No       | Maximum rows you want back. Up to 50,000. Minimum: 1. Maximum: 50000. Default: 10000.                                                                                                                                                                                                                                               |

#### Outputs

| Field         | Type        | Description                                                                                           |
| ------------- | ----------- | ----------------------------------------------------------------------------------------------------- |
| Rows          | dict\_array | Your results - one entry per group, with metrics and dimensions keyed by name.                        |
| Total Rows    | integer     | How many rows Profound has in total for your query - may exceed what was returned if you set a limit. |
| Rows Returned | integer     | How many rows were actually returned to you.                                                          |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/profound.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
