Profound

AI visibility and analytics with Profound

Usage Instructions

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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`categories`	json	List of organization categories
↳ `id`	string	Category ID
↳ `name`	string	Category name

`profound_list_regions`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description

Output

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

`profound_list_models`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description

Output

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

`profound_list_domains`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description

Output

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

`profound_category_tags`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description

Output

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

`profound_category_prompts`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description
`limit`	number	No	No description
`cursor`	string	No	No description
`orderDir`	string	No	No description
`promptType`	string	No	No description
`topicId`	string	No	No description
`tagId`	string	No	No description
`regionId`	string	No	No description
`platformId`	string	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	Yes	No description
`metrics`	string	Yes	Comma-separated metrics: share_of_voice, mentions_count, visibility_score, executions, average_position
`dimensions`	string	No	Comma-separated dimensions: date, region, topic, model, asset_name, prompt, tag, persona
`dateInterval`	string	No	No description
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"asset_name","operator":"is","value":"Company"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	Yes	No description
`metrics`	string	Yes	No description
`dimensions`	string	No	Comma-separated dimensions: theme, date, region, topic, model, asset_name, tag, prompt, sentiment_type, persona
`dateInterval`	string	No	No description
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"asset_name","operator":"is","value":"Company"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	Yes	No description
`metrics`	string	Yes	No description
`dimensions`	string	No	Comma-separated dimensions: hostname, path, date, region, topic, model, tag, prompt, url, root_domain, persona, citation_category
`dateInterval`	string	No	No description
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"hostname","operator":"is","value":"example.com"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	Yes	No description
`metrics`	string	Yes	No description
`dimensions`	string	No	No description
`dateInterval`	string	No	No description
`filters`	string	No	No description
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`categoryId`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	Yes	No description
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"prompt_type","operator":"is","value":"visibility"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`domain`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	No	No description
`metrics`	string	Yes	No description
`dimensions`	string	No	No description
`dateInterval`	string	No	No description
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"bot_name","operator":"is","value":"GPTBot"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`domain`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	No	No description
`metrics`	string	Yes	No description
`dimensions`	string	No	No description
`dateInterval`	string	No	No description
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"referral_source","operator":"is","value":"openai"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`domain`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	No	No description
`dimensions`	string	No	Comma-separated dimensions: timestamp, method, host, path, status_code, ip, user_agent, referer, bytes_sent, duration_ms, query_params
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"path","operator":"contains","value":"/blog"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`domain`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	No	No description
`dimensions`	string	No	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	No	JSON array of filter objects, e.g. [{"field":"bot_name","operator":"is","value":"GPTBot"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`assetId`	string	Yes	No description
`limit`	number	No	No description
`offset`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`assetId`	string	Yes	No description
`contentId`	string	Yes	No description

Output

Parameter	Type	Description
`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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`startDate`	string	Yes	No description
`endDate`	string	Yes	No description
`metrics`	string	Yes	No description
`dimensions`	string	No	Comma-separated dimensions: keyword, date, platform, country_code, matching_type, frequency
`dateInterval`	string	No	No description
`filters`	string	No	JSON array of filter objects, e.g. [{"field":"keyword","operator":"contains","value":"best"}]
`limit`	number	No	No description

Output

Parameter	Type	Description
`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`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`inputDomain`	string	Yes	No description

Output

Parameter	Type	Description
`data`	json	Citation prompt data for the queried domain

On this page

Usage Instructions

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

Start building today

Trusted by over 100,000 builders.

The SaaS platform to build AI agents and run your agentic workforce.