Profound Tools

Profound measures how your brand appears across AI platforms (ChatGPT, Gemini, Perplexity, and more): visibility scores, sentiment, citations, bot traffic, referrals, content optimization, and prompt volume. Use these tools in a workflow to pull AI-search analytics for categories, assets, and domains and feed them into downstream reporting or alerting blocks.

Overview

Operations

Configuration

Every operation requires an apiKey (secret) sent as the X-API-Key header. It is marked user-only (it is never supplied by the LLM).

profound_list_categories

profound_list_assets

profound_list_domains

profound_list_models

profound_list_personas

profound_list_regions

profound_category_assets

profound_category_personas

profound_category_prompts

profound_category_tags

profound_category_topics

profound_list_optimizations

profound_optimization_analysis

profound_citation_prompts

profound_visibility_report

profound_citations_report

profound_sentiment_report

profound_query_fanouts

profound_prompt_answers

profound_prompt_volume

profound_bots_report

profound_referrals_report

profound_bot_logs

profound_raw_logs

Outputs

profound_list_categories

• categories (json) — List of organization categories (each with id, name)

profound_list_assets

• assets (json) — List of assets (each with id, name, website, alternateDomains, isOwned, createdAt, logoUrl)

profound_list_domains

• domains (json) — List of domains

profound_list_models

• models (json) — List of AI models

profound_list_personas

• personas (json) — List of personas

profound_list_regions

• regions (json) — List of regions

profound_category_assets

• assets (json) — List of assets in the category (each with id, name, website, alternateDomains, isOwned, createdAt, logoUrl)

profound_category_personas

• personas (json) — List of personas in the category

profound_category_prompts

• prompts (json) — List of prompts in the category
• cursor (string) — Pagination cursor
• hasMore (boolean) — Whether more results are available

profound_category_tags

• tags (json) — List of tags in the category (each with id, name)

profound_category_topics

• topics (json) — List of topics in the category (each with id, name)

profound_list_optimizations

• totalRows (number) — Total number of optimization entries
• optimizations (json) — List of content optimization entries (each with id, title, createdAt, extractedInput, type, status)

profound_optimization_analysis

• analysis (json) — Detailed content optimization analysis

profound_citation_prompts

• data (json) — Citation prompt data for the queried domain

profound_visibility_report

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics (array of metric values) and dimensions (array of dimension values)

profound_citations_report

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_sentiment_report

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_query_fanouts

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_prompt_answers

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_prompt_volume

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_bots_report

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_referrals_report

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_bot_logs

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

profound_raw_logs

• totalRows (number) — Total number of rows in the report
• data (json) — Report data rows, each with metrics and dimensions

YAML Example

profound_1:
  type: profound
  name: "Profound"
  inputs:
    operation: "visibility_report"
    apiKey: "{{PROFOUND_API_KEY}}"
    categoryId: "00000000-0000-0000-0000-000000000000"
    startDate: "2026-05-01"
    endDate: "2026-05-31"
    visibilityMetrics: "share_of_voice, visibility_score, mentions_count"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Store your Profound API key as an environment variable or workspace secret and reference it with {{PROFOUND_API_KEY}} — it is sent as the X-API-Key header and never passed by the LLM.
• Category-scoped reports (visibility, sentiment, citations, query fanouts, prompt answers) need a categoryId UUID — pull it first from profound_list_categories and reference it like {{profound_categories.categories}}. Domain reports (bots, referrals, raw logs, bot logs) need a domain instead.
• The metrics and dimensions fields are comma-separated strings; valid values differ per report (e.g. share_of_voice for visibility, positive,negative,occurrences for sentiment). The optional filters field must be a JSON array of {"field","operator","value"} objects — invalid JSON throws an "Invalid JSON in filters parameter" error.
• Report tools return rows under data as parallel metrics/dimensions arrays (column order matches the order you requested), so map the returned arrays back to your requested metric/dimension names downstream. Bots and referrals reports use the Profound v2 API; everything else uses v1.