Profound

AI visibility and analytics with Profound

Nutzungsanweisungen

Track how your brand appears across AI platforms. Monitor visibility scores, sentiment, citations, bot traffic, referrals, content optimization, and prompt volumes with Profound.

Tools

`profound_list_categories`

List all organization categories in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key

Ausgabe

Parameter	Typ	Beschreibung
`categories`	json	List of organization categories
↳ `id`	string	Category ID
↳ `name`	string	Category name

`profound_list_regions`

List all organization regions in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key

Ausgabe

Parameter	Typ	Beschreibung
`regions`	json	List of organization regions
↳ `id`	string	Region ID (UUID)
↳ `name`	string	Region name

`profound_list_models`

List all AI models/platforms tracked in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key

Ausgabe

Parameter	Typ	Beschreibung
`models`	json	List of AI models/platforms
↳ `id`	string	Model ID (UUID)
↳ `name`	string	Model/platform name

`profound_list_domains`

List all organization domains in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key

Ausgabe

Parameter	Typ	Beschreibung
`domains`	json	List of organization domains
↳ `id`	string	Domain ID (UUID)
↳ `name`	string	Domain name
↳ `createdAt`	string	When the domain was added

`profound_list_assets`

List all organization assets (companies/brands) across all categories in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key

Ausgabe

Parameter	Typ	Beschreibung
`assets`	json	List of organization assets with category info
↳ `id`	string	Asset ID
↳ `name`	string	Asset/company name
↳ `website`	string	Asset website URL
↳ `alternateDomains`	json	Alternate domain names
↳ `isOwned`	boolean	Whether this asset is owned by the organization
↳ `createdAt`	string	When the asset was created
↳ `logoUrl`	string	URL of the asset logo
↳ `categoryId`	string	Category ID the asset belongs to
↳ `categoryName`	string	Category name

`profound_list_personas`

List all organization personas across all categories in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key

Ausgabe

Parameter	Typ	Beschreibung
`personas`	json	List of organization personas with profile details
↳ `id`	string	Persona ID
↳ `name`	string	Persona name
↳ `categoryId`	string	Category ID
↳ `categoryName`	string	Category name
↳ `persona`	json	Persona profile with behavior, employment, and demographics

`profound_category_topics`

List topics for a specific category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)

Ausgabe

Parameter	Typ	Beschreibung
`topics`	json	List of topics in the category
↳ `id`	string	Topic ID (UUID)
↳ `name`	string	Topic name

`profound_category_tags`

List tags for a specific category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)

Ausgabe

Parameter	Typ	Beschreibung
`tags`	json	List of tags in the category
↳ `id`	string	Tag ID (UUID)
↳ `name`	string	Tag name

`profound_category_prompts`

List prompts for a specific category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)
`limit`	number	Nein	Maximum number of results (default 10000, max 10000)
`cursor`	string	Nein	Pagination cursor from previous response
`orderDir`	string	Nein	Sort direction: asc or desc (default desc)
`promptType`	string	Nein	Comma-separated prompt types to filter: visibility, sentiment
`topicId`	string	Nein	Comma-separated topic IDs (UUIDs) to filter by
`tagId`	string	Nein	Comma-separated tag IDs (UUIDs) to filter by
`regionId`	string	Nein	Comma-separated region IDs (UUIDs) to filter by
`platformId`	string	Nein	Comma-separated platform IDs (UUIDs) to filter by

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of prompts
`nextCursor`	string	Cursor for next page of results
`prompts`	json	List of prompts
↳ `id`	string	Prompt ID
↳ `prompt`	string	Prompt text
↳ `promptType`	string	Prompt type (visibility or sentiment)
↳ `topicId`	string	Topic ID
↳ `topicName`	string	Topic name
↳ `tags`	json	Associated tags
↳ `regions`	json	Associated regions
↳ `platforms`	json	Associated platforms
↳ `createdAt`	string	When the prompt was created

`profound_category_assets`

List assets (companies/brands) for a specific category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)

Ausgabe

Parameter	Typ	Beschreibung
`assets`	json	List of assets in the category
↳ `id`	string	Asset ID
↳ `name`	string	Asset/company name
↳ `website`	string	Website URL
↳ `alternateDomains`	json	Alternate domain names
↳ `isOwned`	boolean	Whether the asset is owned by the organization
↳ `createdAt`	string	When the asset was created
↳ `logoUrl`	string	URL of the asset logo

`profound_category_personas`

List personas for a specific category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)

Ausgabe

Parameter	Typ	Beschreibung
`personas`	json	List of personas in the category
↳ `id`	string	Persona ID
↳ `name`	string	Persona name
↳ `persona`	json	Persona profile with behavior, employment, and demographics

`profound_visibility_report`

Query AI visibility report for a category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Ja	End date (YYYY-MM-DD or ISO 8601)
`metrics`	string	Ja	Comma-separated metrics: share_of_voice, mentions_count, visibility_score, executions, average_position
`dimensions`	string	Nein	Comma-separated dimensions: date, region, topic, model, asset_name, prompt, tag, persona
`dateInterval`	string	Nein	Date interval: hour, day, week, month, year
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"asset_name","operator":"is","value":"Company"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of rows in the report
`data`	json	Report data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values matching requested metrics order
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_sentiment_report`

Query sentiment report for a category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Ja	End date (YYYY-MM-DD or ISO 8601)
`metrics`	string	Ja	Comma-separated metrics: positive, negative, occurrences
`dimensions`	string	Nein	Comma-separated dimensions: theme, date, region, topic, model, asset_name, tag, prompt, sentiment_type, persona
`dateInterval`	string	Nein	Date interval: hour, day, week, month, year
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"asset_name","operator":"is","value":"Company"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of rows in the report
`data`	json	Report data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values matching requested metrics order
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_citations_report`

Query citations report for a category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Ja	End date (YYYY-MM-DD or ISO 8601)
`metrics`	string	Ja	Comma-separated metrics: count, citation_share
`dimensions`	string	Nein	Comma-separated dimensions: hostname, path, date, region, topic, model, tag, prompt, url, root_domain, persona, citation_category
`dateInterval`	string	Nein	Date interval: hour, day, week, month, year
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"hostname","operator":"is","value":"example.com"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of rows in the report
`data`	json	Report data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values matching requested metrics order
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_query_fanouts`

Query fanout report showing how AI models expand prompts into sub-queries in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Ja	End date (YYYY-MM-DD or ISO 8601)
`metrics`	string	Ja	Comma-separated metrics: fanouts_per_execution, total_fanouts, share
`dimensions`	string	Nein	Comma-separated dimensions: prompt, query, model, region, date
`dateInterval`	string	Nein	Date interval: hour, day, week, month, year
`filters`	string	Nein	JSON array of filter objects
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of rows in the report
`data`	json	Report data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values matching requested metrics order
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_prompt_answers`

Get raw prompt answers data for a category in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`categoryId`	string	Ja	Category ID (UUID)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Ja	End date (YYYY-MM-DD or ISO 8601)
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"prompt_type","operator":"is","value":"visibility"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of answer rows
`data`	json	Raw prompt answer data
↳ `prompt`	string	The prompt text
↳ `promptType`	string	Prompt type (visibility or sentiment)
↳ `response`	string	AI model response text
↳ `mentions`	json	Companies/assets mentioned in the response
↳ `citations`	json	URLs cited in the response
↳ `topic`	string	Topic name
↳ `region`	string	Region name
↳ `model`	string	AI model/platform name
↳ `asset`	string	Asset name
↳ `createdAt`	string	Timestamp when the answer was collected

`profound_bots_report`

Query bot traffic report with hourly granularity for a domain in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`domain`	string	Ja	Domain to query bot traffic for (e.g. example.com)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Nein	End date (YYYY-MM-DD or ISO 8601). Defaults to now
`metrics`	string	Ja	Comma-separated metrics: count, citations, indexing, training, last_visit
`dimensions`	string	Nein	Comma-separated dimensions: date, hour, path, bot_name, bot_provider, bot_type
`dateInterval`	string	Nein	Date interval: hour, day, week, month, year
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"bot_name","operator":"is","value":"GPTBot"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of rows in the report
`data`	json	Report data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values matching requested metrics order
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_referrals_report`

Query human referral traffic report with hourly granularity for a domain in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`domain`	string	Ja	Domain to query referral traffic for (e.g. example.com)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Nein	End date (YYYY-MM-DD or ISO 8601). Defaults to now
`metrics`	string	Ja	Comma-separated metrics: visits, last_visit
`dimensions`	string	Nein	Comma-separated dimensions: date, hour, path, referral_source, referral_type
`dateInterval`	string	Nein	Date interval: hour, day, week, month, year
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"referral_source","operator":"is","value":"openai"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of rows in the report
`data`	json	Report data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values matching requested metrics order
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_raw_logs`

Get raw traffic logs with filters for a domain in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`domain`	string	Ja	Domain to query logs for (e.g. example.com)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Nein	End date (YYYY-MM-DD or ISO 8601). Defaults to now
`dimensions`	string	Nein	Comma-separated dimensions: timestamp, method, host, path, status_code, ip, user_agent, referer, bytes_sent, duration_ms, query_params
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"path","operator":"contains","value":"/blog"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of log entries
`data`	json	Log data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values (count)
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_bot_logs`

Get identified bot visit logs with filters for a domain in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`domain`	string	Ja	Domain to query bot logs for (e.g. example.com)
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Nein	End date (YYYY-MM-DD or ISO 8601). Defaults to now
`dimensions`	string	Nein	Comma-separated dimensions: timestamp, method, host, path, status_code, ip, user_agent, referer, bytes_sent, duration_ms, query_params, bot_name, bot_provider, bot_types
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"bot_name","operator":"is","value":"GPTBot"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of bot log entries
`data`	json	Bot log data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values (count)
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_list_optimizations`

List content optimization entries for an asset in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`assetId`	string	Ja	Asset ID (UUID)
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)
`offset`	number	Nein	Offset for pagination (default 0)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of optimization entries
`optimizations`	json	List of content optimization entries
↳ `id`	string	Optimization ID (UUID)
↳ `title`	string	Content title
↳ `createdAt`	string	When the optimization was created
↳ `extractedInput`	string	Extracted input text
↳ `type`	string	Content type: file, text, or url
↳ `status`	string	Optimization status

`profound_optimization_analysis`

Get detailed content optimization analysis for a specific content item in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`assetId`	string	Ja	Asset ID (UUID)
`contentId`	string	Ja	Content/optimization ID (UUID)

Ausgabe

Parameter	Typ	Beschreibung
`content`	json	The analyzed content
↳ `format`	string	Content format: markdown or html
↳ `value`	string	Content text
`aeoContentScore`	json	AEO content score with target zone
↳ `value`	number	AEO score value
↳ `targetZone`	json	Target zone range
↳ `low`	number	Low end of target range
↳ `high`	number	High end of target range
`analysis`	json	Analysis breakdown by category
↳ `breakdown`	json	Array of scoring breakdowns
↳ `title`	string	Category title
↳ `weight`	number	Category weight
↳ `score`	number	Category score
`recommendations`	json	Content optimization recommendations
↳ `title`	string	Recommendation title
↳ `status`	string	Status: done or pending
↳ `impact`	json	Impact details with section and score
↳ `suggestion`	json	Suggestion text and rationale
↳ `text`	string	Suggestion text
↳ `rationale`	string	Why this recommendation matters

`profound_prompt_volume`

Query prompt volume data to understand search demand across AI platforms in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`startDate`	string	Ja	Start date (YYYY-MM-DD or ISO 8601)
`endDate`	string	Ja	End date (YYYY-MM-DD or ISO 8601)
`metrics`	string	Ja	Comma-separated metrics: volume, change
`dimensions`	string	Nein	Comma-separated dimensions: keyword, date, platform, country_code, matching_type, frequency
`dateInterval`	string	Nein	Date interval: hour, day, week, month, year
`filters`	string	Nein	JSON array of filter objects, e.g. [{"field":"keyword","operator":"contains","value":"best"}]
`limit`	number	Nein	Maximum number of results (default 10000, max 50000)

Ausgabe

Parameter	Typ	Beschreibung
`totalRows`	number	Total number of rows in the report
`data`	json	Volume data rows with metrics and dimension values
↳ `metrics`	json	Array of metric values matching requested metrics order
↳ `dimensions`	json	Array of dimension values matching requested dimensions order

`profound_citation_prompts`

Get prompts that cite a specific domain across AI platforms in Profound

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Profound API Key
`inputDomain`	string	Ja	Domain to look up citations for (e.g. ramp.com)

Ausgabe

Parameter	Typ	Beschreibung
`data`	json	Citation prompt data for the queried domain

On this page

Nutzungsanweisungen

profound_list_categories

profound_list_regions

profound_list_models

profound_list_domains

profound_list_assets

profound_list_personas

profound_category_topics

profound_category_tags

profound_category_prompts

profound_category_assets

profound_category_personas

profound_visibility_report

profound_sentiment_report

profound_citations_report

profound_query_fanouts

profound_prompt_answers

profound_bots_report

profound_referrals_report

profound_raw_logs

profound_bot_logs

profound_list_optimizations

profound_optimization_analysis

profound_prompt_volume

profound_citation_prompts