profoundai 0.35.1 → 0.37.0

package/src/resources/reports.ts

@@ -50,6 +50,39 @@ export class Reports extends APIResource {
     return this._client.post('/v1/reports/bots', { body, ...options });
   }
 
+  /**
+   * Get bot traffic report from the hourly aggregated materialized view (UTC-based).
+   *
+   * Supports date_interval="day" (default, UTC daily buckets) or "hour" (UTC hourly
+   * buckets).
+   *
+   * Metrics:
+   *
+   * - count: unique bot visits
+   * - citations: unique citation events (ai_assistant bot type)
+   * - indexing: unique indexing events (index bot type)
+   * - training: unique training events (ai_training bot type)
+   * - last_visit: most recent visit timestamp
+   *
+   * Dimensions:
+   *
+   * - date, path, bot_name, bot_provider, bot_type
+   *
+   * @example
+   * ```ts
+   * const reportResponse = await client.reports.getBotsReportV2(
+   *   {
+   *     domain: 'domain',
+   *     metrics: ['count'],
+   *     start_date: '2019-12-27T18:11:19.117Z',
+   *   },
+   * );
+   * ```
+   */
+  getBotsReportV2(body: ReportGetBotsReportV2Params, options?: RequestOptions): APIPromise<ReportResponse> {
+    return this._client.post('/v2/reports/bots', { body, ...options });
+  }
+
   /**
    * Get referral traffic report from the daily aggregated materialized view.
    *
@@ -73,6 +106,47 @@ export class Reports extends APIResource {
     return this._client.post('/v1/reports/referrals', { body, ...options });
   }
 
+  /**
+   * Get referral traffic report from the hourly aggregated materialized view
+   * (UTC-based).
+   *
+   * Supports date_interval="day" (default, UTC daily buckets) or "hour" (UTC hourly
+   * buckets).
+   *
+   * @example
+   * ```ts
+   * const reportResponse =
+   *   await client.reports.getReferralsReportV2({
+   *     domain: 'domain',
+   *     metrics: ['visits'],
+   *     start_date: '2019-12-27T18:11:19.117Z',
+   *   });
+   * ```
+   */
+  getReferralsReportV2(
+    body: ReportGetReferralsReportV2Params,
+    options?: RequestOptions,
+  ): APIPromise<ReportResponse> {
+    return this._client.post('/v2/reports/referrals', { body, ...options });
+  }
+
+  /**
+   * Query Fanouts
+   *
+   * @example
+   * ```ts
+   * const reportResponse = await client.reports.queryFanouts({
+   *   category_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   end_date: '2019-12-27T18:11:19.117Z',
+   *   metrics: ['fanouts_per_execution'],
+   *   start_date: '2019-12-27T18:11:19.117Z',
+   * });
+   * ```
+   */
+  queryFanouts(body: ReportQueryFanoutsParams, options?: RequestOptions): APIPromise<ReportResponse> {
+    return this._client.post('/v1/reports/query-fanouts', { body, ...options });
+  }
+
   /**
    * Get citations for a given category.
    *
@@ -108,6 +182,17 @@ export class Reports extends APIResource {
   }
 }
 
+/**
+ * Filter by prompt UUID.
+ */
+export interface PromptIDFilter {
+  field: 'prompt_id';
+
+  operator: 'is' | 'not_is' | 'in' | 'not_in';
+
+  value: string | Array<string>;
+}
+
 /**
  * Base model for report information.
  */
@@ -219,18 +304,19 @@ export interface ReportCitationsParams {
   filters?: Array<
     | ReportCitationsParams.HostnameFilter
     | Shared.PathFilter
-    | ReportCitationsParams.ProfoundAnswerEngineInsightsFiltersRegionIDFilter
-    | ReportCitationsParams.ProfoundAnswerEngineInsightsFiltersTopicIDFilter
+    | Shared.RegionIDFilter
+    | Shared.TopicIDFilter
     | TopicNameFilter
-    | ReportCitationsParams.ProfoundAnswerEngineInsightsFiltersModelIDFilter
-    | ReportCitationsParams.ProfoundAnswerEngineInsightsFiltersTagIDFilter
+    | Shared.ModelIDFilter
+    | Shared.TagIDFilter
+    | ReportCitationsParams.TagNameFilter
     | ReportCitationsParams.URLFilter
     | ReportCitationsParams.RootDomainFilter
-    | ReportCitationsParams.ProfoundAnswerEngineInsightsFiltersPromptTypeFilter
-    | ReportCitationsParams.ProfoundAnswerEngineInsightsFiltersPersonaIDFilter
+    | Shared.PromptTypeFilter
+    | Shared.PersonaIDFilter
     | ReportCitationsParams.CitationCategoryFilter
     | Shared.PromptFilter
-    | ReportCitationsParams.ProfoundAnswerEngineInsightsFiltersPromptIDFilter
+    | PromptIDFilter
   >;
 
   /**
@@ -271,55 +357,11 @@ export namespace ReportCitationsParams {
     value: string | Array<string>;
   }
 
-  export interface ProfoundAnswerEngineInsightsFiltersRegionIDFilter {
-    /**
-     * - `region` - Deprecated
-     */
-    field: 'region_id' | 'region';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersTopicIDFilter {
-    /**
-     * - `topic` - Deprecated
-     */
-    field: 'topic_id' | 'topic';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersModelIDFilter {
-    /**
-     * - `model` - Deprecated
-     */
-    field: 'model_id' | 'model';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersTagIDFilter {
-    /**
-     * - `tag` - Deprecated
-     */
-    field: 'tag_id' | 'tag';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
   /**
-   * Filter by URL
+   * Filter by tag name.
    */
-  export interface URLFilter {
-    field: 'url';
+  export interface TagNameFilter {
+    field: 'tag_name';
 
     operator:
       | 'is'
@@ -336,10 +378,10 @@ export namespace ReportCitationsParams {
   }
 
   /**
-   * Filter by root domain
+   * Filter by URL
    */
-  export interface RootDomainFilter {
-    field: 'root_domain';
+  export interface URLFilter {
+    field: 'url';
 
     operator:
       | 'is'
@@ -356,10 +398,10 @@ export namespace ReportCitationsParams {
   }
 
   /**
-   * Filter by prompt type (visibility or sentiment)
+   * Filter by root domain
    */
-  export interface ProfoundAnswerEngineInsightsFiltersPromptTypeFilter {
-    field: 'prompt_type';
+  export interface RootDomainFilter {
+    field: 'root_domain';
 
     operator:
       | 'is'
@@ -372,14 +414,6 @@ export namespace ReportCitationsParams {
       | 'contains_case_insensitive'
       | 'not_contains_case_insensitive';
 
-    value: 'visibility' | 'sentiment' | Array<'visibility' | 'sentiment'>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersPersonaIDFilter {
-    field: 'persona_id';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
     value: string | Array<string>;
   }
 
@@ -402,14 +436,6 @@ export namespace ReportCitationsParams {
 
     value: string | Array<string>;
   }
-
-  export interface ProfoundAnswerEngineInsightsFiltersPromptIDFilter {
-    field: 'prompt_id';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
 }
 
 export interface ReportGetBotsReportParams {
@@ -442,11 +468,71 @@ export interface ReportGetBotsReportParams {
    */
   end_date?: string;
 
+  /**
+   * Filters for bots report.
+   */
+  filters?: Array<Shared.PathFilter | Shared.BotNameFilter | Shared.BotProviderFilter>;
+
+  /**
+   * Custom ordering of the report results.
+   *
+   * The order is a record of key-value pairs where:
+   *
+   * - key is the field to order by, which can be a metric or dimension
+   * - value is the direction of the order, either 'asc' for ascending or 'desc' for
+   *   descending.
+   *
+   * When not specified, the default order is the first metric in the query
+   * descending.
+   */
+  order_by?: { [key: string]: 'asc' | 'desc' };
+
+  organization_id?: string | null;
+
+  /**
+   * Pagination settings for the report results.
+   */
+  pagination?: Shared.Pagination;
+}
+
+export interface ReportGetBotsReportV2Params {
+  /**
+   * Domain to query logs for.
+   */
+  domain: string;
+
+  metrics: Array<'count' | 'citations' | 'indexing' | 'training' | 'last_visit'>;
+
+  /**
+   * Start date for logs. Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS,
+   * or full ISO timestamp.
+   */
+  start_date: string;
+
+  /**
+   * Date interval for the report. (only used with date dimension)
+   */
+  date_interval?: 'hour' | 'day' | 'week' | 'month' | 'year' | 'relative_week';
+
+  /**
+   * Dimensions to group the report by.
+   */
+  dimensions?: Array<'date' | 'hour' | 'path' | 'bot_name' | 'bot_provider' | 'bot_type'>;
+
+  /**
+   * End date in UTC. Accepts same formats as start_date. Defaults to now UTC if
+   * omitted.
+   */
+  end_date?: string;
+
   /**
    * Filters for bots report.
    */
   filters?: Array<
-    Shared.PathFilter | ReportGetBotsReportParams.BotNameFilter | ReportGetBotsReportParams.BotProviderFilter
+    | Shared.PathFilter
+    | Shared.BotNameFilter
+    | Shared.BotProviderFilter
+    | ReportGetBotsReportV2Params.BotTypeFilter
   >;
 
   /**
@@ -471,12 +557,12 @@ export interface ReportGetBotsReportParams {
   pagination?: Shared.Pagination;
 }
 
-export namespace ReportGetBotsReportParams {
+export namespace ReportGetBotsReportV2Params {
   /**
-   * Filter by bot name (user agent)
+   * Filter by bot_type column (v2 hourly table only)
    */
-  export interface BotNameFilter {
-    field: 'bot_name';
+  export interface BotTypeFilter {
+    field: 'bot_type';
 
     operator:
       | 'is'
@@ -490,73 +576,77 @@ export namespace ReportGetBotsReportParams {
       | 'not_contains_case_insensitive';
 
     value:
-      | 'Amazonbot'
-      | 'ClaudeBot'
-      | 'Claude-User'
-      | 'Claude-SearchBot'
-      | 'Applebot'
-      | 'Applebot-Extended'
-      | 'Bytespider'
-      | 'DeepSeek'
-      | 'DuckAssistBot'
-      | 'DuckDuckBot'
-      | 'Googlebot'
-      | 'Googlebot-News'
-      | 'Googlebot-Video'
-      | 'Googlebot-Image'
-      | 'Google-Extended'
-      | 'Storebot-Google'
-      | 'Google-CloudVertexBot'
-      | 'meta-externalfetcher'
-      | 'meta-externalagent'
-      | 'bingbot'
-      | 'MicrosoftPreview'
-      | 'ChatGPT-User'
-      | 'GPTBot'
-      | 'OAI-SearchBot'
-      | 'OAI-Operator'
-      | 'PerplexityBot'
-      | 'Perplexity-User'
-      | 'Grok-PageBrowser'
-      | 'YouBot'
-      | Array<
-          | 'Amazonbot'
-          | 'ClaudeBot'
-          | 'Claude-User'
-          | 'Claude-SearchBot'
-          | 'Applebot'
-          | 'Applebot-Extended'
-          | 'Bytespider'
-          | 'DeepSeek'
-          | 'DuckAssistBot'
-          | 'DuckDuckBot'
-          | 'Googlebot'
-          | 'Googlebot-News'
-          | 'Googlebot-Video'
-          | 'Googlebot-Image'
-          | 'Google-Extended'
-          | 'Storebot-Google'
-          | 'Google-CloudVertexBot'
-          | 'meta-externalfetcher'
-          | 'meta-externalagent'
-          | 'bingbot'
-          | 'MicrosoftPreview'
-          | 'ChatGPT-User'
-          | 'GPTBot'
-          | 'OAI-SearchBot'
-          | 'OAI-Operator'
-          | 'PerplexityBot'
-          | 'Perplexity-User'
-          | 'Grok-PageBrowser'
-          | 'YouBot'
-        >;
+      | 'ai_assistant'
+      | 'ai_training'
+      | 'index'
+      | 'ai_agent'
+      | Array<'ai_assistant' | 'ai_training' | 'index' | 'ai_agent'>;
   }
+}
+
+export interface ReportGetReferralsReportParams {
+  /**
+   * Domain to query logs for.
+   */
+  domain: string;
+
+  metrics: Array<'visits' | 'last_visit'>;
+
+  /**
+   * Start date for logs. Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS,
+   * or full ISO timestamp.
+   */
+  start_date: string;
 
   /**
-   * Filter by bot provider
+   * Date interval for the report. (only used with date dimension)
    */
-  export interface BotProviderFilter {
-    field: 'bot_provider';
+  date_interval?: 'hour' | 'day' | 'week' | 'month' | 'year' | 'relative_week';
+
+  /**
+   * Dimensions to group the report by.
+   */
+  dimensions?: Array<'date' | 'path' | 'referral_source'>;
+
+  /**
+   * End date for logs. Accepts same formats as start_date. Defaults to now if
+   * omitted.
+   */
+  end_date?: string;
+
+  /**
+   * Filters for referrals report.
+   */
+  filters?: Array<Shared.PathFilter | ReportGetReferralsReportParams.ReferralSourceFilter>;
+
+  /**
+   * Custom ordering of the report results.
+   *
+   * The order is a record of key-value pairs where:
+   *
+   * - key is the field to order by, which can be a metric or dimension
+   * - value is the direction of the order, either 'asc' for ascending or 'desc' for
+   *   descending.
+   *
+   * When not specified, the default order is the first metric in the query
+   * descending.
+   */
+  order_by?: { [key: string]: 'asc' | 'desc' };
+
+  organization_id?: string | null;
+
+  /**
+   * Pagination settings for the report results.
+   */
+  pagination?: Shared.Pagination;
+}
+
+export namespace ReportGetReferralsReportParams {
+  /**
+   * Filter by referral source
+   */
+  export interface ReferralSourceFilter {
+    field: 'referral_source';
 
     operator:
       | 'is'
@@ -571,43 +661,33 @@ export namespace ReportGetBotsReportParams {
 
     value:
       | 'openai'
+      | 'none'
       | 'anthropic'
-      | 'chatgpt'
       | 'deepseek'
-      | 'google'
-      | 'microsoft'
       | 'perplexity'
-      | 'apple'
-      | 'bytedance'
-      | 'amazon'
-      | 'meta'
-      | 'duckduckgo'
       | 'you'
-      | 'xai'
       | 'grok'
+      | 'microsoft'
       | 'gemini'
+      | 'internal'
+      | 'other'
       | Array<
           | 'openai'
+          | 'none'
           | 'anthropic'
-          | 'chatgpt'
           | 'deepseek'
-          | 'google'
-          | 'microsoft'
           | 'perplexity'
-          | 'apple'
-          | 'bytedance'
-          | 'amazon'
-          | 'meta'
-          | 'duckduckgo'
           | 'you'
-          | 'xai'
           | 'grok'
+          | 'microsoft'
           | 'gemini'
+          | 'internal'
+          | 'other'
         >;
   }
 }
 
-export interface ReportGetReferralsReportParams {
+export interface ReportGetReferralsReportV2Params {
   /**
    * Domain to query logs for.
    */
@@ -629,10 +709,10 @@ export interface ReportGetReferralsReportParams {
   /**
    * Dimensions to group the report by.
    */
-  dimensions?: Array<'date' | 'path' | 'referral_source'>;
+  dimensions?: Array<'date' | 'hour' | 'path' | 'referral_source' | 'referral_type'>;
 
   /**
-   * End date for logs. Accepts same formats as start_date. Defaults to now if
+   * End date in UTC. Accepts same formats as start_date. Defaults to now UTC if
    * omitted.
    */
   end_date?: string;
@@ -640,7 +720,11 @@ export interface ReportGetReferralsReportParams {
   /**
    * Filters for referrals report.
    */
-  filters?: Array<Shared.PathFilter | ReportGetReferralsReportParams.ReferralSourceFilter>;
+  filters?: Array<
+    | Shared.PathFilter
+    | ReportGetReferralsReportV2Params.ReferralSourceFilter
+    | ReportGetReferralsReportV2Params.ReferralTypeFilter
+  >;
 
   /**
    * Custom ordering of the report results.
@@ -664,7 +748,7 @@ export interface ReportGetReferralsReportParams {
   pagination?: Shared.Pagination;
 }
 
-export namespace ReportGetReferralsReportParams {
+export namespace ReportGetReferralsReportV2Params {
   /**
    * Filter by referral source
    */
@@ -708,6 +792,76 @@ export namespace ReportGetReferralsReportParams {
           | 'other'
         >;
   }
+
+  /**
+   * Filter by referral type
+   */
+  export interface ReferralTypeFilter {
+    field: 'referral_type';
+
+    operator:
+      | 'is'
+      | 'not_is'
+      | 'in'
+      | 'not_in'
+      | 'contains'
+      | 'not_contains'
+      | 'matches'
+      | 'contains_case_insensitive'
+      | 'not_contains_case_insensitive';
+
+    value: 'internal' | 'referer' | 'utm' | 'none' | Array<'internal' | 'referer' | 'utm' | 'none'>;
+  }
+}
+
+export interface ReportQueryFanoutsParams {
+  category_id: string;
+
+  /**
+   * End date. Accepts YYYY-MM-DD, YYYY-MM-DD HH:MM, or ISO timestamp.
+   */
+  end_date: string;
+
+  metrics: Array<'fanouts_per_execution' | 'total_fanouts' | 'share'>;
+
+  /**
+   * Start date. Accepts YYYY-MM-DD, YYYY-MM-DD HH:MM, or ISO timestamp.
+   */
+  start_date: string;
+
+  /**
+   * Date interval for the report. (only used with date dimension)
+   */
+  date_interval?: 'hour' | 'day' | 'week' | 'month' | 'year' | 'relative_week';
+
+  /**
+   * Dimensions to group the report by.
+   */
+  dimensions?: Array<'prompt' | 'query' | 'model' | 'region' | 'date'>;
+
+  /**
+   * Filters to apply to the query fanout report.
+   */
+  filters?: Array<
+    | Shared.RegionIDFilter
+    | Shared.ModelIDFilter
+    | Shared.TopicIDFilter
+    | Shared.TagIDFilter
+    | PromptIDFilter
+    | Shared.PersonaIDFilter
+    | Shared.PromptTypeFilter
+  >;
+
+  /**
+   * Custom ordering. Keys must be a requested metric or the `date` dimension. Values
+   * are `asc` or `desc`. Defaults to first metric descending.
+   */
+  order_by?: { [key: string]: 'asc' | 'desc' };
+
+  /**
+   * Pagination settings for the report results.
+   */
+  pagination?: Shared.Pagination;
 }
 
 export interface ReportSentimentParams {
@@ -758,13 +912,14 @@ export interface ReportSentimentParams {
     | ReportSentimentParams.AssetIDFilter
     | Shared.AssetNameFilter
     | ReportSentimentParams.ThemeFilter
-    | ReportSentimentParams.ProfoundAnswerEngineInsightsFiltersRegionIDFilter
-    | ReportSentimentParams.ProfoundAnswerEngineInsightsFiltersTopicIDFilter
+    | Shared.RegionIDFilter
+    | Shared.TopicIDFilter
     | TopicNameFilter
-    | ReportSentimentParams.ProfoundAnswerEngineInsightsFiltersModelIDFilter
-    | ReportSentimentParams.ProfoundAnswerEngineInsightsFiltersTagIDFilter
+    | Shared.ModelIDFilter
+    | Shared.TagIDFilter
+    | ReportSentimentParams.TagNameFilter
     | Shared.PromptFilter
-    | ReportSentimentParams.ProfoundAnswerEngineInsightsFiltersPersonaIDFilter
+    | Shared.PersonaIDFilter
   >;
 
   /**
@@ -816,54 +971,22 @@ export namespace ReportSentimentParams {
     value: string | Array<string>;
   }
 
-  export interface ProfoundAnswerEngineInsightsFiltersRegionIDFilter {
-    /**
-     * - `region` - Deprecated
-     */
-    field: 'region_id' | 'region';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersTopicIDFilter {
-    /**
-     * - `topic` - Deprecated
-     */
-    field: 'topic_id' | 'topic';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersModelIDFilter {
-    /**
-     * - `model` - Deprecated
-     */
-    field: 'model_id' | 'model';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersTagIDFilter {
-    /**
-     * - `tag` - Deprecated
-     */
-    field: 'tag_id' | 'tag';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersPersonaIDFilter {
-    field: 'persona_id';
+  /**
+   * Filter by tag name.
+   */
+  export interface TagNameFilter {
+    field: 'tag_name';
 
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
+    operator:
+      | 'is'
+      | 'not_is'
+      | 'in'
+      | 'not_in'
+      | 'contains'
+      | 'not_contains'
+      | 'matches'
+      | 'contains_case_insensitive'
+      | 'not_contains_case_insensitive';
 
     value: string | Array<string>;
   }
@@ -914,15 +1037,16 @@ export interface ReportVisibilityParams {
    * List of filters to apply to the visibility report.
    */
   filters?: Array<
-    | ReportVisibilityParams.ProfoundAnswerEngineInsightsFiltersRegionIDFilter
-    | ReportVisibilityParams.ProfoundAnswerEngineInsightsFiltersModelIDFilter
-    | ReportVisibilityParams.ProfoundAnswerEngineInsightsFiltersTopicIDFilter
+    | Shared.RegionIDFilter
+    | Shared.ModelIDFilter
+    | Shared.TopicIDFilter
     | TopicNameFilter
     | Shared.AssetNameFilter
-    | ReportVisibilityParams.ProfoundAnswerEngineInsightsFiltersTagIDFilter
-    | ReportVisibilityParams.ProfoundAnswerEngineInsightsFiltersPromptIDFilter
+    | Shared.TagIDFilter
+    | ReportVisibilityParams.TagNameFilter
+    | PromptIDFilter
     | Shared.PromptFilter
-    | ReportVisibilityParams.ProfoundAnswerEngineInsightsFiltersPersonaIDFilter
+    | Shared.PersonaIDFilter
   >;
 
   /**
@@ -946,62 +1070,22 @@ export interface ReportVisibilityParams {
 }
 
 export namespace ReportVisibilityParams {
-  export interface ProfoundAnswerEngineInsightsFiltersRegionIDFilter {
-    /**
-     * - `region` - Deprecated
-     */
-    field: 'region_id' | 'region';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersModelIDFilter {
-    /**
-     * - `model` - Deprecated
-     */
-    field: 'model_id' | 'model';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersTopicIDFilter {
-    /**
-     * - `topic` - Deprecated
-     */
-    field: 'topic_id' | 'topic';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersTagIDFilter {
-    /**
-     * - `tag` - Deprecated
-     */
-    field: 'tag_id' | 'tag';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersPromptIDFilter {
-    field: 'prompt_id';
-
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
-
-    value: string | Array<string>;
-  }
-
-  export interface ProfoundAnswerEngineInsightsFiltersPersonaIDFilter {
-    field: 'persona_id';
+  /**
+   * Filter by tag name.
+   */
+  export interface TagNameFilter {
+    field: 'tag_name';
 
-    operator: 'is' | 'not_is' | 'in' | 'not_in';
+    operator:
+      | 'is'
+      | 'not_is'
+      | 'in'
+      | 'not_in'
+      | 'contains'
+      | 'not_contains'
+      | 'matches'
+      | 'contains_case_insensitive'
+      | 'not_contains_case_insensitive';
 
     value: string | Array<string>;
   }
@@ -1009,6 +1093,7 @@ export namespace ReportVisibilityParams {
 
 export declare namespace Reports {
   export {
+    type PromptIDFilter as PromptIDFilter,
     type ReportInfo as ReportInfo,
     type ReportResponse as ReportResponse,
     type ReportResult as ReportResult,
@@ -1016,7 +1101,10 @@ export declare namespace Reports {
     type ReportCitationsResponse as ReportCitationsResponse,
     type ReportCitationsParams as ReportCitationsParams,
     type ReportGetBotsReportParams as ReportGetBotsReportParams,
+    type ReportGetBotsReportV2Params as ReportGetBotsReportV2Params,
     type ReportGetReferralsReportParams as ReportGetReferralsReportParams,
+    type ReportGetReferralsReportV2Params as ReportGetReferralsReportV2Params,
+    type ReportQueryFanoutsParams as ReportQueryFanoutsParams,
     type ReportSentimentParams as ReportSentimentParams,
     type ReportVisibilityParams as ReportVisibilityParams,
   };