@llmpulse/sdk 1.61.0 → 1.63.0

package/src/apis/SentimentsApi.ts

@@ -4,7 +4,7 @@
  * LLM Pulse API
  * REST API client for LLM Pulse AI visibility analytics.
  *
- * The version of the OpenAPI document: 1.61.0
+ * The version of the OpenAPI document: 1.63.0
  * Contact: info@llmpulse.ai
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -18,12 +18,64 @@ import {
     ApiErrorFromJSON,
     ApiErrorToJSON,
 } from '../models/ApiError';
+import {
+    type SentimentTagsResponse,
+    SentimentTagsResponseFromJSON,
+    SentimentTagsResponseToJSON,
+} from '../models/SentimentTagsResponse';
+import {
+    type SentimentTopicsResponse,
+    SentimentTopicsResponseFromJSON,
+    SentimentTopicsResponseToJSON,
+} from '../models/SentimentTopicsResponse';
 import {
     type SentimentsResponse,
     SentimentsResponseFromJSON,
     SentimentsResponseToJSON,
 } from '../models/SentimentsResponse';
 
+export interface GetSentimentTagsRequest {
+    projectId: number;
+    range?: number;
+    from?: Date;
+    to?: Date;
+    model?: GetSentimentTagsModelEnum;
+    collectionId?: string;
+    countryCode?: string;
+    languageCode?: string;
+    brandKind?: GetSentimentTagsBrandKindEnum;
+    analysis?: string;
+    topic?: string;
+    query?: string;
+    brand?: string;
+    sort?: GetSentimentTagsSortEnum;
+    sortDir?: GetSentimentTagsSortDirEnum;
+    page?: number;
+    perPage?: number;
+    output?: GetSentimentTagsOutputEnum;
+}
+
+export interface GetSentimentTopicsRequest {
+    projectId: number;
+    range?: number;
+    from?: Date;
+    to?: Date;
+    model?: GetSentimentTopicsModelEnum;
+    collectionId?: string;
+    countryCode?: string;
+    languageCode?: string;
+    brandKind?: GetSentimentTopicsBrandKindEnum;
+    analysis?: string;
+    topic?: string;
+    query?: string;
+    brand?: string;
+    sort?: GetSentimentTopicsSortEnum;
+    sortDir?: GetSentimentTopicsSortDirEnum;
+    page?: number;
+    perPage?: number;
+    output?: GetSentimentTopicsOutputEnum;
+}
+
 export interface ListSentimentCategoriesRequest {
     projectId: number;
     output?: ListSentimentCategoriesOutputEnum;
@@ -51,6 +103,122 @@ export interface ListSentimentRecordsRequest {
  * @interface SentimentsApiInterface
  */
 export interface SentimentsApiInterface {
+    /**
+     * Creates request options for getSentimentTags without sending the request
+     * @param {number} projectId Project ID
+     * @param {number} [range] Number of days to look back, today included (default 28, like the Sentiment page). Ignored when from or to is given.
+     * @param {Date} [from] 
+     * @param {Date} [to] End of the window. A date-only value such as 2026-09-01 covers that whole day. Pass a full timestamp to end the window earlier.
+     * @param {'chatgpt' | 'perplexity' | 'ai_mode' | 'ai_overview' | 'gemini' | 'copilot' | 'amazon_rufus' | 'claude' | 'grok' | 'deepseek' | 'naver_ai' | 'baidu_ai' | 'meta_ai'} [model] Filter by one AI model. It must be a model enabled for the API key\'s user: an unknown value, or a model the user has not enabled, returns 422 ERR_INVALID_PARAM with the valid values in the message.
+     * @param {string} [collectionId] One collection/tag ID or a comma-separated list of IDs. A query value is always a string on the wire, so it is typed as one: the previous integer-or-string union made generators emit a wrapper type they could not serialize.
+     * @param {string} [countryCode] One ISO country code or a comma-separated list (e.g. US,GB,DE)
+     * @param {string} [languageCode] One ISO language code or a comma-separated list (e.g. en,es,de)
+     * @param {'brand' | 'brand_other' | 'non_brand'} [brandKind] Filter by brand kind: brand (own brand/products), brand_other (competitors/other brands), non_brand (generic, no brand named). For fair 1:1 brand-vs-competitor comparisons (visibility, share of voice), use non_brand: brand-focused prompts skew results toward the brand they name. The in-app Overview page applies non_brand by default.
+     * @param {string} [analysis] One sentiment level or a comma-separated list: very_positive, positive, neutral, negative, very_negative
+     * @param {string} [topic] Only sentiments tagged with this topic (case-insensitive)
+     * @param {string} [query] Only sentiments whose answer or prompt text contains this text
+     * @param {string} [brand] Whose sentiment to count. Empty or omitted for your own brand, all for every brand, or a competitor id (an unknown id returns ERR_INVALID_PARAM).
+     * @param {'mentions' | 'name' | 'positive' | 'negative' | 'neutral' | 'net_score'} [sort] Sort column: mentions, name (the topic or tag), positive, negative or neutral (their shares) or net_score. Ties sort by name.
+     * @param {'desc' | 'asc'} [sortDir] 
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @param {'flat' | 'csv'} [output] Rectangular output for BI tools (Tableau, Excel, Sheets, ELT). Omit for the default nested JSON. \'flat\' returns the same metadata plus \'columns\' and \'rows\'; \'csv\' returns those rows as text/csv. Errors are always returned as JSON.
+     * @throws {RequiredError}
+     * @memberof SentimentsApiInterface
+     */
+    getSentimentTagsRequestOpts(requestParameters: GetSentimentTagsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * One row per tag of the project with at least one analyzed mention, with the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score. A mention counts once for every tag its prompt carries, as on the Sentiment page. Same filters as GET /reports/sentiment/topics. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * @summary Sentiment by tag (Growth plan or above)
+     * @param {number} projectId Project ID
+     * @param {number} [range] Number of days to look back, today included (default 28, like the Sentiment page). Ignored when from or to is given.
+     * @param {Date} [from] 
+     * @param {Date} [to] End of the window. A date-only value such as 2026-09-01 covers that whole day. Pass a full timestamp to end the window earlier.
+     * @param {'chatgpt' | 'perplexity' | 'ai_mode' | 'ai_overview' | 'gemini' | 'copilot' | 'amazon_rufus' | 'claude' | 'grok' | 'deepseek' | 'naver_ai' | 'baidu_ai' | 'meta_ai'} [model] Filter by one AI model. It must be a model enabled for the API key\&#39;s user: an unknown value, or a model the user has not enabled, returns 422 ERR_INVALID_PARAM with the valid values in the message.
+     * @param {string} [collectionId] One collection/tag ID or a comma-separated list of IDs. A query value is always a string on the wire, so it is typed as one: the previous integer-or-string union made generators emit a wrapper type they could not serialize.
+     * @param {string} [countryCode] One ISO country code or a comma-separated list (e.g. US,GB,DE)
+     * @param {string} [languageCode] One ISO language code or a comma-separated list (e.g. en,es,de)
+     * @param {'brand' | 'brand_other' | 'non_brand'} [brandKind] Filter by brand kind: brand (own brand/products), brand_other (competitors/other brands), non_brand (generic, no brand named). For fair 1:1 brand-vs-competitor comparisons (visibility, share of voice), use non_brand: brand-focused prompts skew results toward the brand they name. The in-app Overview page applies non_brand by default.
+     * @param {string} [analysis] One sentiment level or a comma-separated list: very_positive, positive, neutral, negative, very_negative
+     * @param {string} [topic] Only sentiments tagged with this topic (case-insensitive)
+     * @param {string} [query] Only sentiments whose answer or prompt text contains this text
+     * @param {string} [brand] Whose sentiment to count. Empty or omitted for your own brand, all for every brand, or a competitor id (an unknown id returns ERR_INVALID_PARAM).
+     * @param {'mentions' | 'name' | 'positive' | 'negative' | 'neutral' | 'net_score'} [sort] Sort column: mentions, name (the topic or tag), positive, negative or neutral (their shares) or net_score. Ties sort by name.
+     * @param {'desc' | 'asc'} [sortDir] 
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @param {'flat' | 'csv'} [output] Rectangular output for BI tools (Tableau, Excel, Sheets, ELT). Omit for the default nested JSON. \&#39;flat\&#39; returns the same metadata plus \&#39;columns\&#39; and \&#39;rows\&#39;; \&#39;csv\&#39; returns those rows as text/csv. Errors are always returned as JSON.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SentimentsApiInterface
+     */
+    getSentimentTagsRaw(requestParameters: GetSentimentTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SentimentTagsResponse>>;
+
+    /**
+     * One row per tag of the project with at least one analyzed mention, with the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score. A mention counts once for every tag its prompt carries, as on the Sentiment page. Same filters as GET /reports/sentiment/topics. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * Sentiment by tag (Growth plan or above)
+     */
+    getSentimentTags(requestParameters: GetSentimentTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SentimentTagsResponse>;
+
+    /**
+     * Creates request options for getSentimentTopics without sending the request
+     * @param {number} projectId Project ID
+     * @param {number} [range] Number of days to look back, today included (default 28, like the Sentiment page). Ignored when from or to is given.
+     * @param {Date} [from] 
+     * @param {Date} [to] End of the window. A date-only value such as 2026-09-01 covers that whole day. Pass a full timestamp to end the window earlier.
+     * @param {'chatgpt' | 'perplexity' | 'ai_mode' | 'ai_overview' | 'gemini' | 'copilot' | 'amazon_rufus' | 'claude' | 'grok' | 'deepseek' | 'naver_ai' | 'baidu_ai' | 'meta_ai'} [model] Filter by one AI model. It must be a model enabled for the API key\&#39;s user: an unknown value, or a model the user has not enabled, returns 422 ERR_INVALID_PARAM with the valid values in the message.
+     * @param {string} [collectionId] One collection/tag ID or a comma-separated list of IDs. A query value is always a string on the wire, so it is typed as one: the previous integer-or-string union made generators emit a wrapper type they could not serialize.
+     * @param {string} [countryCode] One ISO country code or a comma-separated list (e.g. US,GB,DE)
+     * @param {string} [languageCode] One ISO language code or a comma-separated list (e.g. en,es,de)
+     * @param {'brand' | 'brand_other' | 'non_brand'} [brandKind] Filter by brand kind: brand (own brand/products), brand_other (competitors/other brands), non_brand (generic, no brand named). For fair 1:1 brand-vs-competitor comparisons (visibility, share of voice), use non_brand: brand-focused prompts skew results toward the brand they name. The in-app Overview page applies non_brand by default.
+     * @param {string} [analysis] One sentiment level or a comma-separated list: very_positive, positive, neutral, negative, very_negative
+     * @param {string} [topic] Only sentiments tagged with this topic (case-insensitive)
+     * @param {string} [query] Only sentiments whose answer or prompt text contains this text
+     * @param {string} [brand] Whose sentiment to count. Empty or omitted for your own brand, all for every brand, or a competitor id (an unknown id returns ERR_INVALID_PARAM).
+     * @param {'mentions' | 'name' | 'positive' | 'negative' | 'neutral' | 'net_score'} [sort] Sort column: mentions, name (the topic or tag), positive, negative or neutral (their shares) or net_score. Ties sort by name.
+     * @param {'desc' | 'asc'} [sortDir] 
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @param {'flat' | 'csv'} [output] Rectangular output for BI tools (Tableau, Excel, Sheets, ELT). Omit for the default nested JSON. \&#39;flat\&#39; returns the same metadata plus \&#39;columns\&#39; and \&#39;rows\&#39;; \&#39;csv\&#39; returns those rows as text/csv. Errors are always returned as JSON.
+     * @throws {RequiredError}
+     * @memberof SentimentsApiInterface
+     */
+    getSentimentTopicsRequestOpts(requestParameters: GetSentimentTopicsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * One row per topic AI answers associate with the brand (topics are matched case-insensitively), with its analyzed mentions, the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score ((positive - negative) / mentions x 100). The same rows and filters as the Topics tab of the Sentiment page: the window defaults to the last 28 days, `brand` empty counts your own brand, `all` every brand and a competitor id that competitor. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * @summary Sentiment by topic (Growth plan or above)
+     * @param {number} projectId Project ID
+     * @param {number} [range] Number of days to look back, today included (default 28, like the Sentiment page). Ignored when from or to is given.
+     * @param {Date} [from] 
+     * @param {Date} [to] End of the window. A date-only value such as 2026-09-01 covers that whole day. Pass a full timestamp to end the window earlier.
+     * @param {'chatgpt' | 'perplexity' | 'ai_mode' | 'ai_overview' | 'gemini' | 'copilot' | 'amazon_rufus' | 'claude' | 'grok' | 'deepseek' | 'naver_ai' | 'baidu_ai' | 'meta_ai'} [model] Filter by one AI model. It must be a model enabled for the API key\&#39;s user: an unknown value, or a model the user has not enabled, returns 422 ERR_INVALID_PARAM with the valid values in the message.
+     * @param {string} [collectionId] One collection/tag ID or a comma-separated list of IDs. A query value is always a string on the wire, so it is typed as one: the previous integer-or-string union made generators emit a wrapper type they could not serialize.
+     * @param {string} [countryCode] One ISO country code or a comma-separated list (e.g. US,GB,DE)
+     * @param {string} [languageCode] One ISO language code or a comma-separated list (e.g. en,es,de)
+     * @param {'brand' | 'brand_other' | 'non_brand'} [brandKind] Filter by brand kind: brand (own brand/products), brand_other (competitors/other brands), non_brand (generic, no brand named). For fair 1:1 brand-vs-competitor comparisons (visibility, share of voice), use non_brand: brand-focused prompts skew results toward the brand they name. The in-app Overview page applies non_brand by default.
+     * @param {string} [analysis] One sentiment level or a comma-separated list: very_positive, positive, neutral, negative, very_negative
+     * @param {string} [topic] Only sentiments tagged with this topic (case-insensitive)
+     * @param {string} [query] Only sentiments whose answer or prompt text contains this text
+     * @param {string} [brand] Whose sentiment to count. Empty or omitted for your own brand, all for every brand, or a competitor id (an unknown id returns ERR_INVALID_PARAM).
+     * @param {'mentions' | 'name' | 'positive' | 'negative' | 'neutral' | 'net_score'} [sort] Sort column: mentions, name (the topic or tag), positive, negative or neutral (their shares) or net_score. Ties sort by name.
+     * @param {'desc' | 'asc'} [sortDir] 
+     * @param {number} [page] 
+     * @param {number} [perPage] 
+     * @param {'flat' | 'csv'} [output] Rectangular output for BI tools (Tableau, Excel, Sheets, ELT). Omit for the default nested JSON. \&#39;flat\&#39; returns the same metadata plus \&#39;columns\&#39; and \&#39;rows\&#39;; \&#39;csv\&#39; returns those rows as text/csv. Errors are always returned as JSON.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SentimentsApiInterface
+     */
+    getSentimentTopicsRaw(requestParameters: GetSentimentTopicsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SentimentTopicsResponse>>;
+
+    /**
+     * One row per topic AI answers associate with the brand (topics are matched case-insensitively), with its analyzed mentions, the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score ((positive - negative) / mentions x 100). The same rows and filters as the Topics tab of the Sentiment page: the window defaults to the last 28 days, `brand` empty counts your own brand, `all` every brand and a competitor id that competitor. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * Sentiment by topic (Growth plan or above)
+     */
+    getSentimentTopics(requestParameters: GetSentimentTopicsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SentimentTopicsResponse>;
+
     /**
      * Creates request options for listSentimentCategories without sending the request
      * @param {number} projectId Project ID
@@ -130,6 +298,258 @@ export interface SentimentsApiInterface {
  */
 export class SentimentsApi extends runtime.BaseAPI implements SentimentsApiInterface {
 
+    /**
+     * Creates request options for getSentimentTags without sending the request
+     */
+    async getSentimentTagsRequestOpts(requestParameters: GetSentimentTagsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling getSentimentTags().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
+        if (requestParameters['range'] != null) {
+            queryParameters['range'] = requestParameters['range'];
+        }
+
+        if (requestParameters['from'] != null) {
+            queryParameters['from'] = (requestParameters['from'] as any).toISOString();
+        }
+
+        if (requestParameters['to'] != null) {
+            queryParameters['to'] = (requestParameters['to'] as any).toISOString();
+        }
+
+        if (requestParameters['model'] != null) {
+            queryParameters['model'] = requestParameters['model'];
+        }
+
+        if (requestParameters['collectionId'] != null) {
+            queryParameters['collection_id'] = requestParameters['collectionId'];
+        }
+
+        if (requestParameters['countryCode'] != null) {
+            queryParameters['country_code'] = requestParameters['countryCode'];
+        }
+
+        if (requestParameters['languageCode'] != null) {
+            queryParameters['language_code'] = requestParameters['languageCode'];
+        }
+
+        if (requestParameters['brandKind'] != null) {
+            queryParameters['brand_kind'] = requestParameters['brandKind'];
+        }
+
+        if (requestParameters['analysis'] != null) {
+            queryParameters['analysis'] = requestParameters['analysis'];
+        }
+
+        if (requestParameters['topic'] != null) {
+            queryParameters['topic'] = requestParameters['topic'];
+        }
+
+        if (requestParameters['query'] != null) {
+            queryParameters['query'] = requestParameters['query'];
+        }
+
+        if (requestParameters['brand'] != null) {
+            queryParameters['brand'] = requestParameters['brand'];
+        }
+
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+
+        if (requestParameters['sortDir'] != null) {
+            queryParameters['sort_dir'] = requestParameters['sortDir'];
+        }
+
+        if (requestParameters['page'] != null) {
+            queryParameters['page'] = requestParameters['page'];
+        }
+
+        if (requestParameters['perPage'] != null) {
+            queryParameters['per_page'] = requestParameters['perPage'];
+        }
+
+        if (requestParameters['output'] != null) {
+            queryParameters['output'] = requestParameters['output'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/reports/sentiment/tags`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * One row per tag of the project with at least one analyzed mention, with the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score. A mention counts once for every tag its prompt carries, as on the Sentiment page. Same filters as GET /reports/sentiment/topics. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * Sentiment by tag (Growth plan or above)
+     */
+    async getSentimentTagsRaw(requestParameters: GetSentimentTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SentimentTagsResponse>> {
+        const requestOptions = await this.getSentimentTagsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SentimentTagsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * One row per tag of the project with at least one analyzed mention, with the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score. A mention counts once for every tag its prompt carries, as on the Sentiment page. Same filters as GET /reports/sentiment/topics. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * Sentiment by tag (Growth plan or above)
+     */
+    async getSentimentTags(requestParameters: GetSentimentTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SentimentTagsResponse> {
+        const response = await this.getSentimentTagsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getSentimentTopics without sending the request
+     */
+    async getSentimentTopicsRequestOpts(requestParameters: GetSentimentTopicsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling getSentimentTopics().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
+        if (requestParameters['range'] != null) {
+            queryParameters['range'] = requestParameters['range'];
+        }
+
+        if (requestParameters['from'] != null) {
+            queryParameters['from'] = (requestParameters['from'] as any).toISOString();
+        }
+
+        if (requestParameters['to'] != null) {
+            queryParameters['to'] = (requestParameters['to'] as any).toISOString();
+        }
+
+        if (requestParameters['model'] != null) {
+            queryParameters['model'] = requestParameters['model'];
+        }
+
+        if (requestParameters['collectionId'] != null) {
+            queryParameters['collection_id'] = requestParameters['collectionId'];
+        }
+
+        if (requestParameters['countryCode'] != null) {
+            queryParameters['country_code'] = requestParameters['countryCode'];
+        }
+
+        if (requestParameters['languageCode'] != null) {
+            queryParameters['language_code'] = requestParameters['languageCode'];
+        }
+
+        if (requestParameters['brandKind'] != null) {
+            queryParameters['brand_kind'] = requestParameters['brandKind'];
+        }
+
+        if (requestParameters['analysis'] != null) {
+            queryParameters['analysis'] = requestParameters['analysis'];
+        }
+
+        if (requestParameters['topic'] != null) {
+            queryParameters['topic'] = requestParameters['topic'];
+        }
+
+        if (requestParameters['query'] != null) {
+            queryParameters['query'] = requestParameters['query'];
+        }
+
+        if (requestParameters['brand'] != null) {
+            queryParameters['brand'] = requestParameters['brand'];
+        }
+
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+
+        if (requestParameters['sortDir'] != null) {
+            queryParameters['sort_dir'] = requestParameters['sortDir'];
+        }
+
+        if (requestParameters['page'] != null) {
+            queryParameters['page'] = requestParameters['page'];
+        }
+
+        if (requestParameters['perPage'] != null) {
+            queryParameters['per_page'] = requestParameters['perPage'];
+        }
+
+        if (requestParameters['output'] != null) {
+            queryParameters['output'] = requestParameters['output'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/reports/sentiment/topics`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * One row per topic AI answers associate with the brand (topics are matched case-insensitively), with its analyzed mentions, the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score ((positive - negative) / mentions x 100). The same rows and filters as the Topics tab of the Sentiment page: the window defaults to the last 28 days, `brand` empty counts your own brand, `all` every brand and a competitor id that competitor. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * Sentiment by topic (Growth plan or above)
+     */
+    async getSentimentTopicsRaw(requestParameters: GetSentimentTopicsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SentimentTopicsResponse>> {
+        const requestOptions = await this.getSentimentTopicsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SentimentTopicsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * One row per topic AI answers associate with the brand (topics are matched case-insensitively), with its analyzed mentions, the positive (very positive included), neutral and negative counts, their shares on a 0-100 scale and the net sentiment score ((positive - negative) / mentions x 100). The same rows and filters as the Topics tab of the Sentiment page: the window defaults to the last 28 days, `brand` empty counts your own brand, `all` every brand and a competitor id that competitor. Requires the Growth plan; lower tiers receive ERR_PLAN_REQUIRED.
+     * Sentiment by topic (Growth plan or above)
+     */
+    async getSentimentTopics(requestParameters: GetSentimentTopicsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SentimentTopicsResponse> {
+        const response = await this.getSentimentTopicsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listSentimentCategories without sending the request
      */
@@ -295,6 +715,118 @@ export class SentimentsApi extends runtime.BaseAPI implements SentimentsApiInter
 
 }
 
+/**
+ * @export
+ */
+export const GetSentimentTagsModelEnum = {
+    Chatgpt: 'chatgpt',
+    Perplexity: 'perplexity',
+    AiMode: 'ai_mode',
+    AiOverview: 'ai_overview',
+    Gemini: 'gemini',
+    Copilot: 'copilot',
+    AmazonRufus: 'amazon_rufus',
+    Claude: 'claude',
+    Grok: 'grok',
+    Deepseek: 'deepseek',
+    NaverAi: 'naver_ai',
+    BaiduAi: 'baidu_ai',
+    MetaAi: 'meta_ai'
+} as const;
+export type GetSentimentTagsModelEnum = typeof GetSentimentTagsModelEnum[keyof typeof GetSentimentTagsModelEnum];
+/**
+ * @export
+ */
+export const GetSentimentTagsBrandKindEnum = {
+    Brand: 'brand',
+    BrandOther: 'brand_other',
+    NonBrand: 'non_brand'
+} as const;
+export type GetSentimentTagsBrandKindEnum = typeof GetSentimentTagsBrandKindEnum[keyof typeof GetSentimentTagsBrandKindEnum];
+/**
+ * @export
+ */
+export const GetSentimentTagsSortEnum = {
+    Mentions: 'mentions',
+    Name: 'name',
+    Positive: 'positive',
+    Negative: 'negative',
+    Neutral: 'neutral',
+    NetScore: 'net_score'
+} as const;
+export type GetSentimentTagsSortEnum = typeof GetSentimentTagsSortEnum[keyof typeof GetSentimentTagsSortEnum];
+/**
+ * @export
+ */
+export const GetSentimentTagsSortDirEnum = {
+    Desc: 'desc',
+    Asc: 'asc'
+} as const;
+export type GetSentimentTagsSortDirEnum = typeof GetSentimentTagsSortDirEnum[keyof typeof GetSentimentTagsSortDirEnum];
+/**
+ * @export
+ */
+export const GetSentimentTagsOutputEnum = {
+    Flat: 'flat',
+    Csv: 'csv'
+} as const;
+export type GetSentimentTagsOutputEnum = typeof GetSentimentTagsOutputEnum[keyof typeof GetSentimentTagsOutputEnum];
+/**
+ * @export
+ */
+export const GetSentimentTopicsModelEnum = {
+    Chatgpt: 'chatgpt',
+    Perplexity: 'perplexity',
+    AiMode: 'ai_mode',
+    AiOverview: 'ai_overview',
+    Gemini: 'gemini',
+    Copilot: 'copilot',
+    AmazonRufus: 'amazon_rufus',
+    Claude: 'claude',
+    Grok: 'grok',
+    Deepseek: 'deepseek',
+    NaverAi: 'naver_ai',
+    BaiduAi: 'baidu_ai',
+    MetaAi: 'meta_ai'
+} as const;
+export type GetSentimentTopicsModelEnum = typeof GetSentimentTopicsModelEnum[keyof typeof GetSentimentTopicsModelEnum];
+/**
+ * @export
+ */
+export const GetSentimentTopicsBrandKindEnum = {
+    Brand: 'brand',
+    BrandOther: 'brand_other',
+    NonBrand: 'non_brand'
+} as const;
+export type GetSentimentTopicsBrandKindEnum = typeof GetSentimentTopicsBrandKindEnum[keyof typeof GetSentimentTopicsBrandKindEnum];
+/**
+ * @export
+ */
+export const GetSentimentTopicsSortEnum = {
+    Mentions: 'mentions',
+    Name: 'name',
+    Positive: 'positive',
+    Negative: 'negative',
+    Neutral: 'neutral',
+    NetScore: 'net_score'
+} as const;
+export type GetSentimentTopicsSortEnum = typeof GetSentimentTopicsSortEnum[keyof typeof GetSentimentTopicsSortEnum];
+/**
+ * @export
+ */
+export const GetSentimentTopicsSortDirEnum = {
+    Desc: 'desc',
+    Asc: 'asc'
+} as const;
+export type GetSentimentTopicsSortDirEnum = typeof GetSentimentTopicsSortDirEnum[keyof typeof GetSentimentTopicsSortDirEnum];
+/**
+ * @export
+ */
+export const GetSentimentTopicsOutputEnum = {
+    Flat: 'flat',
+    Csv: 'csv'
+} as const;
+export type GetSentimentTopicsOutputEnum = typeof GetSentimentTopicsOutputEnum[keyof typeof GetSentimentTopicsOutputEnum];
 /**
  * @export
  */

package/src/apis/ShoppingAdsApi.ts

@@ -4,7 +4,7 @@
  * LLM Pulse API
  * REST API client for LLM Pulse AI visibility analytics.
  *
- * The version of the OpenAPI document: 1.61.0
+ * The version of the OpenAPI document: 1.63.0
  * Contact: info@llmpulse.ai
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).