@goperigon/perigon-ts 1.0.4 → 1.0.5

package/dist/index.d.ts

@@ -2007,7 +2007,7 @@ declare function ArticleToJSONTyped(value?: Article | null, ignoreDiscriminator?
  * Do not edit the class manually.
  */
 /**
- * Filter using sources that are located on specific coordinates using Lat, lon and radius.
+ * Filter articles from publishers based at specific geographic locations. Uses latitude, longitude, and radius parameters to define a circular search area for publisher locations.
  * @export
  * @interface CoordinateFilter
  */
@@ -2053,169 +2053,169 @@ declare function CoordinateFilterToJSONTyped(value?: CoordinateFilter | null, ig
  */
 
 /**
- * A versatile filter object to refine search results based on articles, clusters, sources, languages, categories, locations, companies, and people. Supports logical operators (AND, OR, NOT) for complex queries. Accepts single values or arrays, with arrays applied as OR operations.
+ * Complex filter structure for article searches that supports nested logical operations (AND, OR, NOT) and multiple filtering criteria.
  * @export
  * @interface ArticleSearchFilter
  */
 interface ArticleSearchFilter {
     /**
-     * Filter by specific article(s). Array of article IDs. For convenience, a single string ID is also accepted.
+     * Filter by specific article identifiers. Accepts either a single ID or an array of IDs. Returns only articles matching these IDs.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     articleId?: Array<string> | null;
     /**
-     * Filter by specific cluster(s). Accepts either a single string or an array of strings.
+     * Filter by specific story identifiers. Accepts either a single ID or an array of IDs. Returns only articles belonging to these stories.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     clusterId?: Array<string> | null;
     /**
-     * Filter by specific source(s). Accepts either a single string or an array of strings.
+     * Filter articles by specific publisher domains or subdomains. Accepts either a single domain or an array of domains. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     source?: Array<string> | null;
     /**
-     * The domain of the website, which should be excluded from the search. Multiple parameters could be provided. Wildcards (* and ?) are suported (e.g. *.cnn.com).
+     * Exclude articles from specific publisher domains or subdomains. Accepts either a single domain or an array of domains. Multiple values create an AND-exclude filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeSource?: Array<string> | null;
     /**
-     * Filter by specific source group, for example: 'top100'. Accepts either a single string or an array of strings.
+     * Filter articles using Perigon's curated publisher bundles (e.g., top100, top25tech). Accepts either a single source group or an array. Multiple values create an OR filter to include articles from any of the specified bundles.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     sourceGroup?: Array<string> | null;
     /**
-     * Language code to filter by language. If an array parameters are passed, they will be applied as OR operations. For example: ['en', 'es']. Language ISO codes must be provided.
+     * Filter articles by their language using ISO-639 two-letter codes in lowercase (e.g., en, es, fr). Accepts either a single language code or an array. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     language?: Array<string> | null;
     /**
-     *  A list of languages to be excluded. Any article published in one of the languages provided in this filter will not be returned. This is useful when you are interested only in news published in specific languages.
+     * Exclude articles in specific languages using ISO-639 two-letter codes in lowercase. Accepts either a single language code or an array. Multiple values create an AND-exclude filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeLanguage?: Array<string> | null;
     /**
-     * Labels to filter by, could be 'Opinion', 'Paid-news', 'Non-news', etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles by editorial labels such as Opinion, Paid-news, Non-news, Fact Check, or Press Release. View our docs for an exhaustive list of labels. Accepts either a single label or an array. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     label?: Array<string> | null;
     /**
-     * Exclude results that include specific labels (Opinion, Non-news, Paid News, etc.). You can filter multiple by repeating the parameter.
+     * Exclude articles with specific editorial labels. Accepts either a single label or an array. Multiple values create an AND-exclude filter, removing all content with any of these labels.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeLabel?: Array<string> | null;
     /**
-     * Filters by Google Content Categories. This field will accept 1 or more categories, must pass the full name of the category. Example: taxonomy=/Finance/Banking/Other, /Finance/Investing/Funds
+     * Filter by Google Content Categories. Must pass the full hierarchical path of the category. Accepts either a single path or an array. Example: taxonomy=/Finance/Banking/Other,/Finance/Investing/Funds. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     taxonomy?: Array<string> | null;
     /**
-     * Filter by categories. Categories are general themes that the article is about. Examples of categories: Tech, Politics, etc. If multiple parameters are passed, they will be applied as OR operations. Use 'none' to search uncategorized articles.
+     * Filter by broad content categories such as Politics, Tech, Sports, Business, or Finance. Accepts either a single category or an array. Use none to find uncategorized articles. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     category?: Array<string> | null;
     /**
-     * Filter by topics. Each topic is some kind of entity that the article is about. Examples of topics: Markets, Joe Biden, Green Energy, Climate Change, Cryptocurrency, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter by specific topics such as Markets, Crime, Cryptocurrency, or College Sports. Accepts either a single topic or an array. Topics are more granular than categories, and articles can have multiple topics. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     topic?: Array<string> | null;
     /**
-     * Filter by excluding topics. Each topic is some kind of entity that the article is about. Examples of topics: Markets, Joe Biden, Green Energy, Climate Change, Cryptocurrency, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Exclude articles with specific topics. Accepts either a single topic or an array. Multiple values create an AND-exclude filter, removing all content with any of these topics.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeTopic?: Array<string> | null;
     /**
-     * Country code to filter by country. If multiple parameters are passed, they will be applied as OR operations. Only accepts country ISO codes.
+     * Filter articles by countries they mention using two-letter country codes in lowercase (e.g., us, gb, jp). Accepts either a single country code or an array. Multiple values create an OR filter. See documentation for supported country codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     country?: Array<string> | null;
     /**
-     * Excludes articles from specific countries in the vector search results. Accepts a list of country codes (e.g., 'US', 'UK', 'CA'). Use this parameter to filter out articles published in countries you don't want to include in your search results. See the Country and Language Support section in the documentation for a full list of supported country codes.
+     * Exclude articles from specific countries using two-letter country codes in lowercase. Accepts either a single country code or an array. Multiple values create an AND-exclude filter. See documentation for supported country codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeCountry?: Array<string> | null;
     /**
-     * Filters articles where a specified country plays a central role in the content, beyond mere mentions, to ensure the results are deeply relevant to the country in question. If multiple parameters are passed, they will be applied as OR operations. Only accepts country ISO codes.
+     * Filter articles where specified countries play a central role in the content, not just mentioned. Uses two-letter country codes in lowercase. Accepts either a single country code or an array. Multiple values create an OR filter. See documentation for supported country codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     locationsCountry?: Array<string> | null;
     /**
-     * Excludes articles where a specified country plays a central role in the content, ensuring results are not deeply relevant to the country in question. If multiple parameters are passed, they will be applied as AND operations, excluding articles relevant to any of the specified countries.
+     * Exclude articles where specified countries play a central role in the content. Accepts either a single country code or an array. Multiple values create an AND-exclude filter, removing articles focused on any of these countries. See documentation for supported country codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeLocationsCountry?: Array<string> | null;
     /**
-     * Filters articles where a specified state plays a central role in the content, beyond mere mentions, to ensure the results are deeply relevant to the state in question. If multiple parameters are passed, they will be applied as OR operations. Only accepts state ISO codes.
+     * Filter articles where specified states play a central role in the content. Accepts either a single state code or an array. Multiple values create an OR filter. Uses two-letter state codes in lowercase. See documentation for supported state codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     state?: Array<string> | null;
     /**
-     * A list of states to exclude. Articles that include, or are associated with, any of the states provided here will be filtered out. This is especially useful if you want to ignore news tied to certain geographical areas (e.g., US states).
+     * Exclude articles where specified states play a central role. Accepts either a single state code or an array. Multiple values create an AND-exclude filter, removing articles focused on any of these states. See documentation for supported state codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeState?: Array<string> | null;
     /**
-     * Filters articles where a specified state plays a central role in the content, beyond mere mentions, to ensure the results are deeply relevant to the state in question. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles that mention or are related to specific counties. Accepts either a single county name or an array. Multiple values create an OR filter. County names typically include the word 'County' (e.g., Los Angeles County).
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     county?: Array<string> | null;
     /**
-     * Excludes articles from specific counties or administrative divisions in the vector search results. Accepts either a single county name or a list of county names. County names should match the format used in article metadata (e.g., 'Los Angeles County', 'Cook County'). This parameter allows for more granular geographic filter
+     * Exclude articles that mention or are related to specific counties. Accepts either a single county name or an array. Multiple values create an AND-exclude filter. County names should match the format in article metadata (e.g., Los Angeles County, Cook County).
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeCounty?: Array<string> | null;
     /**
-     * Filters articles where a specified city plays a central role in the content, beyond mere mentions, to ensure the results are deeply relevant to the urban area in question. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles that mention or are related to specific cities. Accepts either a single city name or an array. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     city?: Array<string> | null;
     /**
-     * A list of cities to exclude from the results. Articles that are associated with any of the specified cities will be filtered out.
+     * Exclude articles that mention or are related to specific cities. Accepts either a single city name or an array. Multiple values create an AND-exclude filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeCity?: Array<string> | null;
     /**
-     * Find articles published by sources that are located within a given country. Must be 2 character country code (i.e. us, gb, etc).
+     * Filter for articles from publishers based in specific countries. Accepts either a single country code or an array. Uses two-letter country codes in lowercase (e.g., us, gb). See documentation for supported country codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     sourceCountry?: Array<string> | null;
     /**
-     * Find articles published by sources that are located within a given state.
+     * Filter for articles from publishers based in specific states or regions. Accepts either a single state code or an array. Uses two-letter state codes in lowercase. See documentation for supported state codes.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     sourceState?: Array<string> | null;
     /**
-     * Find articles published by sources that are located within a given county.
+     * Filter for articles from publishers based in specific counties. Accepts either a single county name or an array. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     sourceCounty?: Array<string> | null;
     /**
-     * Find articles published by sources that are located within a given city.
+     * Filter for articles from publishers based in specific cities. Accepts either a single city name or an array. Multiple values create an OR filter.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
@@ -2233,67 +2233,67 @@ interface ArticleSearchFilter {
      */
     sourceCoordinates?: CoordinateFilter;
     /**
-     * List of company IDs to filter by.
+     * Filter articles by company identifiers. Accepts either a single ID or an array. Multiple values create an OR filter. For a complete list of tracked companies and their IDs, refer to the /companies endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     companyId?: Array<string> | null;
     /**
-     * A list of company identifiers. Articles associated with companies that have any of these unique IDs will be filtered out from the returned results, ensuring that certain companies or corporate entities are not included.
+     * Exclude articles mentioning companies with specific identifiers. Accepts either a single ID or an array. Multiple values create an AND-exclude filter. For a complete list of tracked companies and their IDs, refer to the /companies endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeCompanyId?: Array<string> | null;
     /**
-     * Search by company domains for filtering. E.g. companyDomain=apple.com.
+     * Filter articles by company domains (e.g., apple.com). Accepts either a single domain or an array. Multiple values create an OR filter. For a complete list of tracked companies and their domains, refer to the /companies endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     companyDomain?: Array<string> | null;
     /**
-     * A list of company domains to exclude. If an article is related to a company that uses one of the specified domains (for instance, "example.com"), it will not be returned in the results.
+     * Exclude articles related to companies with specific domains. Accepts either a single domain or an array. Multiple values create an AND-exclude filter. For a complete list of tracked companies and their domains, refer to the /companies endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeCompanyDomain?: Array<string> | null;
     /**
-     * Search by company symbols.
+     * Filter articles by company stock symbols (e.g., AAPL, MSFT). Accepts either a single symbol or an array. Multiple values create an OR filter. For a complete list of tracked companies and their symbols, refer to the /companies endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     companySymbol?: Array<string> | null;
     /**
-     * A list of stock symbols (ticker symbols) that identify companies to be excluded. Articles related to companies using any of these symbols will be omitted, which is useful for targeting or avoiding specific public companies.
+     * Exclude articles related to companies with specific stock symbols. Accepts either a single symbol or an array. Multiple values create an AND-exclude filter. For a complete list of tracked companies and their symbols, refer to the /companies endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludeCompanySymbol?: Array<string> | null;
     /**
-     * Search by company name.
+     * Filter articles by company name mentions. Accepts either a single name or an array. Performs exact matching on company names. Multiple values create an OR filter. For a complete list of tracked companies and their names, refer to the /companies endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     companyName?: Array<string> | null;
     /**
-     * List of person Wikidata IDs for filtering.
+     * Filter articles by Wikidata IDs of mentioned people. Accepts either a single ID or an array. Multiple values create an OR filter. For a complete list of tracked individuals and their Wikidata IDs, refer to the /people endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     personWikidataId?: Array<string> | null;
     /**
-     * A list of Wikidata identifiers for individuals. Articles mentioning persons with any of these Wikidata IDs will be filtered out. This is particularly helpful when using a unique identifier to prevent ambiguity in names.
+     * Exclude articles mentioning people with specific Wikidata IDs. Accepts either a single ID or an array. Multiple values create an AND-exclude filter. For a complete list of tracked individuals and their Wikidata IDs, refer to the /people endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     excludePersonWikidataId?: Array<string> | null;
     /**
-     * List of person names for exact matches. Boolean and complex logic is not supported on this filter.
+     * Filter articles by exact person name matches. Accepts either a single name or an array. Does not support Boolean operators or wildcards. Multiple values create an OR filter. For a complete list of tracked individuals and their names, refer to the /people endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
     personName?: Array<string> | null;
     /**
-     * A list of person names that, when associated with the content, cause the article to be excluded. This filter removes articles related to any individuals whose names match those on the list.
+     * Exclude articles mentioning specific people by name. Accepts either a single name or an array. Multiple values create an AND-exclude filter. For a complete list of tracked individuals and their names, refer to the /people endpoint.
      * @type {Array<string>}
      * @memberof ArticleSearchFilter
      */
@@ -2386,24 +2386,6 @@ interface ArticleSearchParams {
      * @memberof ArticleSearchParams
      */
     page?: number | null;
-    /**
-     *
-     * @type {Date}
-     * @memberof ArticleSearchParams
-     */
-    addDateFrom?: Date | null;
-    /**
-     *
-     * @type {Date}
-     * @memberof ArticleSearchParams
-     */
-    addDateTo?: Date | null;
-    /**
-     *
-     * @type {number}
-     * @memberof ArticleSearchParams
-     */
-    scoreThreshold?: number | null;
 }
 /**
  * Check if a given object implements the ArticleSearchParams interface.
@@ -4663,87 +4645,87 @@ interface GetJournalistByIdRequest {
 }
 interface SearchArticlesRequest {
     /**
-     * Search query, each article will be scored and ranked against it. Articles are searched on the title, description, and content fields.
+     * Primary search query for filtering articles based on their title, description, and content. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     q?: string;
     /**
-     * Search article headlines/title field. Semantic similar to q parameter.
+     * Search specifically within article headlines/titles. Supports Boolean operators, exact phrases with quotes, and wildcards for matching title variations.
      */
     title?: string;
     /**
-     * Search query on the description field. Semantic similar to q parameter.
+     * Search within article description fields. Supports Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching.
      */
     desc?: string;
     /**
-     * Search query on the article\&#39;s body of content field. Semantic similar to q parameter.
+     * Search within the full article body content. Supports Boolean logic, exact phrase matching with quotes, and wildcards for comprehensive content searching.
      */
     content?: string;
     /**
-     * Search query on the url field. Semantic similar to q parameter. E.g. could be used for querying certain website sections, e.g. source&#x3D;cnn.com&amp;url&#x3D;travel.
+     * Search within article URLs to find content from specific website sections or domains. Supports wildcards (* and ?) for partial URL matching.
      */
     url?: string;
     /**
-     * Article ID will search for a news article by the ID of the article. If several parameters are passed, all matched articles will be returned.
+     * Retrieve specific news articles by their unique article identifiers. Multiple IDs can be provided to return a collection of specific articles.
      */
     articleId?: Array<string>;
     /**
-     * Search for related content using a cluster ID. Passing a cluster ID will filter results to only the content found within the cluster.
+     * Filter results to only show content within a specific related content cluster. Returns articles grouped together as part of Perigon Stories based on topic relevance.
      */
     clusterId?: Array<string>;
     /**
-     * \&#39;relevance\&#39; to sort by relevance to the query, \&#39;date\&#39; to sort by the publication date (desc), \&#39;pubDate\&#39; is a synonym to \&#39;date\&#39;, \&#39;addDate\&#39; to sort by \&#39;addDate\&#39; field (desc), \&#39;refreshDate\&#39; to sort by \&#39;refreshDate\&#39; field (desc). Defaults to \&#39;relevance\&#39;
+     * Determines the article sorting order. Options include relevance (default), date/pubDate (newest publication date first), reverseDate (oldest publication date first), addDate (newest ingestion date first), reverseAddDate (oldest ingestion date first), and refreshDate (most recently updated in system first, often identical to addDate).
      */
     sortBy?: AllEndpointSortBy;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
     /**
-     * The number of items per page.
+     * The number of articles to return per page in the paginated response.
      */
     size?: number;
     /**
-     * \&#39;from\&#39; filter, will search articles published after the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2023-03-01T00:00:00
+     * Filter for articles published after this date. Accepts ISO 8601 format (e.g., 2023-03-01T00:00:00) or yyyy-mm-dd format.
      */
     from?: Date;
     /**
-     * \&#39;to\&#39; filter, will search articles published before the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T23:59:59
+     * Filter for articles published before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.
      */
     to?: Date;
     /**
-     * \&#39;addDateFrom\&#39; filter, will search articles added after the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T00:00:00
+     * Filter for articles added to Perigon\&#39;s system after this date. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or yyyy-mm-dd format.
      */
     addDateFrom?: Date;
     /**
-     * \&#39;addDateTo\&#39; filter, will search articles added before the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T23:59:59
+     * Filter for articles added to Perigon\&#39;s system before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.
      */
     addDateTo?: Date;
     /**
-     * Will search articles that were refreshed after the specified date. The date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T00:00:00
+     * Filter for articles refreshed/updated in Perigon\&#39;s system after this date. In most cases yields similar results to addDateFrom but can differ for updated content. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or yyyy-mm-dd format.
      */
     refreshDateFrom?: Date;
     /**
-     * Will search articles that were refreshed before the specified date. The date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T23:59:59
+     * Filter for articles refreshed/updated in Perigon\&#39;s system before this date. In most cases yields similar results to addDateTo but can differ for updated content. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.
      */
     refreshDateTo?: Date;
     /**
-     * Medium will filter out news articles medium, which could be \&#39;Video\&#39; or \&#39;Article\&#39;. If several parameters are passed, all matched articles will be returned.
+     * Filter articles by their primary medium type. Accepts Article for written content or Video for video-based stories. Multiple values create an OR filter.
      */
     medium?: Array<string>;
     /**
-     * Publisher\&#39;s domain can include a subdomain. If multiple parameters are passed, they will be applied as OR operations. Wildcards (* and ?) are suported (e.g. *.cnn.com).
+     * Filter articles by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an OR filter.
      */
     source?: Array<string>;
     /**
-     * One of the supported source groups. Find Source Groups in the guided part of our documentation...
+     * Filter articles using Perigon\&#39;s curated publisher bundles (e.g., top100, top25crypto). Multiple values create an OR filter to include articles from any of the specified bundles.
      */
     sourceGroup?: Array<string>;
     /**
-     * A list of built-in source group names to exclude from the results. The Perigon API categorizes sources into groups (for example, “top10” or “top100”) based on type or popularity. Using this filter allows you to remove articles coming from any source that belongs to one or more of the specified groups.
+     * Exclude articles from specified Perigon source groups. Multiple values create an AND-exclude filter, removing content from publishers in any of the specified bundles (e.g., top10, top100).
      */
     excludeSourceGroup?: Array<string>;
     /**
-     * The domain of the website, which should be excluded from the search. Multiple parameters could be provided. Wildcards (* and ?) are suported (e.g. *.cnn.com).
+     * Exclude articles from specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an AND-exclude filter.
      */
     excludeSource?: Array<string>;
     /**
@@ -4751,71 +4733,71 @@ interface SearchArticlesRequest {
      */
     paywall?: boolean;
     /**
-     * Author names to filter by. Article author bylines are used as a source field. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles by author bylines. Works as an exact match for each author name provided. Multiple values create an OR filter to find articles by any of the specified authors.
      */
     byline?: Array<string>;
     /**
-     * A list of author names to include. Only articles written by any of the specified authors are returned. This is ideal when you wish to focus on content from particular voices or experts.
+     * Filter articles by specific author names. Works as an exact match for each name. Multiple values create an OR filter to find articles by any of the specified authors.
      */
     author?: Array<string>;
     /**
-     *  A list of author names to exclude from the search results. Any article written by an author whose name matches one in this list will be omitted, which helps to avoid content from certain individuals.
+     * Exclude articles written by specific authors. Any article with an author name matching an entry in this list will be omitted from results. Multiple values create an AND-exclude filter.
      */
     excludeAuthor?: Array<string>;
     /**
-     * Filter by journalist ID. Journalist IDs are unique journalist identifiers which can be found through the Journalist API, or in the matchedAuthors field.
+     * Filter by unique journalist identifiers which can be found through the Journalist API or in the matchedAuthors field. Multiple values create an OR filter.
      */
     journalistId?: Array<string>;
     /**
-     * A list of journalist (or reporter) identifiers to exclude. If an article is written by a journalist whose ID matches any in this list, it will not be part of the result set.
+     * Exclude articles written by specific journalists identified by their unique IDs. Multiple values create an AND-exclude filter.
      */
     excludeJournalistId?: Array<string>;
     /**
-     * Language code to filter by language. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles by their language using ISO-639 two-letter codes (e.g., en, es, fr). Multiple values create an OR filter.
      */
     language?: Array<string>;
     /**
-     *  A list of languages to be excluded. Any article published in one of the languages provided in this filter will not be returned. This is useful when you are interested only in news published in specific languages.
+     * Exclude articles in specific languages using ISO-639 two-letter codes. Multiple values create an AND-exclude filter.
      */
     excludeLanguage?: Array<string>;
     /**
-     * Expand a query to search the translation, translatedTitle, and translatedDescription fields for non-English articles.
+     * Expand search to include translated content fields for non-English articles. When true, searches translated title, description, and content fields.
      */
     searchTranslation?: boolean;
     /**
-     * Labels to filter by, could be \&#39;Opinion\&#39;, \&#39;Paid-news\&#39;, \&#39;Non-news\&#39;, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles by editorial labels such as Opinion, Paid-news, Non-news, Fact Check, or Press Release. Multiple values create an OR filter.
      */
     label?: Array<string>;
     /**
-     * Exclude results that include specific labels (Opinion, Non-news, Paid News, etc.). You can filter multiple by repeating the parameter.
+     * Exclude articles with specific editorial labels. Multiple values create an AND-exclude filter, removing all content with any of these labels.
      */
     excludeLabel?: Array<string>;
     /**
-     * Filter by categories. Categories are general themes that the article is about. Examples of categories: Tech, Politics, etc. If multiple parameters are passed, they will be applied as OR operations. Use \&#39;none\&#39; to search uncategorized articles.
+     * Filter by broad content categories such as Politics, Tech, Sports, Business, or Finance. Use \&#39;none\&#39; to find uncategorized articles. Multiple values create an OR filter.
      */
     category?: Array<string>;
     /**
-     * A list of article categories to be omitted. If an article is tagged with any category present in this list (such as “Polotics”, “Tech”, “Sports”, etc.), it will not appear in the search results.
+     * Exclude articles with specific categories. Multiple values create an AND-exclude filter, removing all content with any of these categories.
      */
     excludeCategory?: Array<string>;
     /**
-     * Filters results to include only articles with the specified topics. Topics are more specific classifications than categories, with an article potentially having multiple topics assigned. Perigon uses both human and machine curation to maintain an evolving list of available topics. Common examples include \&#39;Markets\&#39;, \&#39;Crime\&#39;, \&#39;Cryptocurrency\&#39;, \&#39;Social Issues\&#39;, \&#39;College Sports\&#39;, etc. See the Topics page in Docs for a complete list of available topics.
+     * Filter by specific topics such as Markets, Crime, Cryptocurrency, or College Sports. Topics are more granular than categories, and articles can have multiple topics. Use the /topics endpoint for a complete list of available topics. Multiple values create an OR filter.
      */
     topic?: Array<string>;
     /**
-     * Filter by excluding topics. Each topic is some kind of entity that the article is about. Examples of topics: Markets, Joe Biden, Green Energy, Climate Change, Cryptocurrency, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Exclude articles with specific topics. Multiple values create an AND-exclude filter, removing all content with any of these topics.
      */
     excludeTopic?: Array<string>;
     /**
-     * Returns only articles that point to specified links (as determined by the \&#39;links\&#39; field in the article response).
+     * Returns only articles that contain links to the specified URL pattern. Matches against the \&#39;links\&#39; field in article responses.
      */
     linkTo?: string;
     /**
-     * Whether to return reprints in the response or not. Reprints are usually wired articles from sources like AP or Reuters that are reprinted in multiple sources at the same time. By default, this parameter is \&#39;true\&#39;.
+     * Controls whether to include reprinted content in results. When true (default), shows syndicated articles from wire services like AP or Reuters that appear on multiple sites.
      */
     showReprints?: boolean;
     /**
-     * Shows all articles belonging to the same reprint group. A reprint group includes one original article (the first one processed by the API) and all its known reprints.
+     * Returns all articles in a specific reprint group, including the original article and all its known reprints. Use when you want to see all versions of the same content.
      */
     reprintGroupId?: string;
     /**
@@ -4903,43 +4885,43 @@ interface SearchArticlesRequest {
      */
     sourceMaxDistance?: number;
     /**
-     * List of person Wikidata IDs for filtering.
+     * Filter articles by Wikidata IDs of mentioned people. Refer to the /people endpoint for a complete list of tracked individuals.
      */
     personWikidataId?: Array<string>;
     /**
-     * A list of Wikidata identifiers for individuals. Articles mentioning persons with any of these Wikidata IDs will be filtered out. This is particularly helpful when using a unique identifier to prevent ambiguity in names.
+     * Exclude articles mentioning people with specific Wikidata IDs. Creates an AND-exclude filter to remove content about these individuals. Uses precise identifiers to avoid name ambiguity.
      */
     excludePersonWikidataId?: Array<string>;
     /**
-     * List of person names for exact matches. Boolean and complex logic is not supported on this paramter.
+     * Filter articles by exact person name matches. Does not support Boolean or complex logic. For available person entities, consult the /people endpoint.
      */
     personName?: Array<string>;
     /**
-     * A list of person names that, when associated with the content, cause the article to be excluded. This filter removes articles related to any individuals whose names match those on the list.
+     * Exclude articles mentioning specific people by name. Creates an AND-exclude filter to remove content about these individuals.
      */
     excludePersonName?: Array<string>;
     /**
-     * List of company IDs to filter by.
+     * Filter articles by company identifiers. For a complete list of tracked companies, refer to the /companies endpoint.
      */
     companyId?: Array<string>;
     /**
-     * A list of company identifiers. Articles associated with companies that have any of these unique IDs will be filtered out from the returned results, ensuring that certain companies or corporate entities are not included.
+     * Exclude articles mentioning companies with specific identifiers. Creates an AND-exclude filter to remove content about these corporate entities.
      */
     excludeCompanyId?: Array<string>;
     /**
-     * Search by company name.
+     * Filter articles by company name mentions. Performs an exact match on company names.
      */
     companyName?: string;
     /**
-     * Search by company domains for filtering. E.g. companyDomain&#x3D;apple.com.
+     * Filter articles by company domains (e.g., apple.com). For available company entities, consult the /companies endpoint.
      */
     companyDomain?: Array<string>;
     /**
-     * A list of company domains to exclude. If an article is related to a company that uses one of the specified domains (for instance, “example.com”), it will not be returned in the results.
+     * Exclude articles related to companies with specific domains. Creates an AND-exclude filter to remove content about these companies.
      */
     excludeCompanyDomain?: Array<string>;
     /**
-     * Search by company symbols.
+     * Filter articles by company stock symbols. For available company entities and their symbols, consult the /companies endpoint.
      */
     companySymbol?: Array<string>;
     /**
@@ -4951,31 +4933,31 @@ interface SearchArticlesRequest {
      */
     showNumResults?: boolean;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating positive sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a positive sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone.
      */
     positiveSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating positive sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a positive sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone.
      */
     positiveSentimentTo?: number;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating neutral sentiment. Explanation of sentimental values can be found in Docs under the Article Data section.
+     * Filter articles with a neutral sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone.
      */
     neutralSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating neutral sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a neutral sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone.
      */
     neutralSentimentTo?: number;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating negative sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a negative sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone.
      */
     negativeSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating negative sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a negative sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone.
      */
     negativeSentimentTo?: number;
     /**
-     * Filters by Google Content Categories. This field will accept 1 or more categories, must pass the full name of the category. Example: taxonomy&#x3D;/Finance/Banking/Other, /Finance/Investing/Funds
+     * Filters by Google Content Categories. This field will accept 1 or more categories, must pass the full name of the category. Example: taxonomy&#x3D;/Finance/Banking/Other, /Finance/Investing/Funds. [Full list](https://cloud.google.com/natural-language/docs/categories)
      */
     taxonomy?: Array<string>;
     /**
@@ -4985,279 +4967,283 @@ interface SearchArticlesRequest {
 }
 interface SearchCompaniesRequest {
     /**
-     * Search by company id.
+     * Filter by unique company identifiers. Multiple values create an OR filter.
      */
     id?: Array<string>;
     /**
-     * Search by ticker symbol.
+     * Filter by company stock ticker symbols (e.g., AAPL, MSFT, GOOGL). Multiple values create an OR filter.
      */
     symbol?: Array<string>;
     /**
-     * Search by company domain.
+     * Filter by company domains or websites (e.g., apple.com, microsoft.com). Multiple values create an OR filter.
      */
     domain?: Array<string>;
     /**
-     * Search by company country.
+     * Filter by company headquarters country. Multiple values create an OR filter.
      */
     country?: Array<string>;
     /**
-     * Search by exchange name.
+     * Filter by stock exchange where companies are listed (e.g., NASDAQ, NYSE). Multiple values create an OR filter.
      */
     exchange?: Array<string>;
     /**
-     * Minimum number of employees.
+     * Filter for companies with at least this many employees.
      */
     numEmployeesFrom?: number;
     /**
-     * Maximum number of employees.
+     * Filter for companies with no more than this many employees.
      */
     numEmployeesTo?: number;
     /**
-     * Starting IPO date.
+     * Filter for companies that went public on or after this date. Accepts ISO 8601 format (e.g., 2023-01-01T00:00:00) or yyyy-mm-dd format.
      */
     ipoFrom?: Date;
     /**
-     * Ending IPO date.
+     * Filter for companies that went public on or before this date. Accepts ISO 8601 format (e.g., 2023-12-31T23:59:59) or yyyy-mm-dd format.
      */
     ipoTo?: Date;
     /**
-     * Search companies over \&#39;name\&#39;, \&#39;altNames\&#39;, \&#39;domains\&#39; and \&#39;symbols.symbol\&#39; fields. Boolean operators and logic are supported.
+     * Primary search query for filtering companies across name, alternative names, domains, and ticker symbols. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     q?: string;
     /**
-     * Search by company name. Boolean operators and logic are supported.
+     * Search within company names. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     name?: string;
     /**
-     * Search by industry. Boolean operators and logic are supported.
+     * Filter by company industry classifications. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     industry?: string;
     /**
-     * Search by sector. Boolean operators and logic are supported.
+     * Filter by company sector classifications. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     sector?: string;
     /**
-     * The number of items per page.
+     * The number of companies to return per page in the paginated response.
      */
     size?: number;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
 }
-interface SearchJournalists1Request {
+interface SearchJournalistsRequest {
     /**
-     * Filter by journalist ID. Journalist IDs are unique journalist identifiers which can be found through the Journalist API, or in the matchedAuthors field.
+     * Filter by unique journalist identifiers. Multiple values create an OR filter to find journalists matching any of the specified IDs.
      */
     id?: Array<string>;
     /**
-     * Searches through name, title, twitterBio fields with priority given to the name, then to the title, then to the twitter bio. Returns results sorted by relevance.
+     * Primary search query for filtering journalists based on their name, title, and Twitter bio. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     q?: string;
     /**
-     * Searches through journalist names, scores and ranks them, returns results sorted by relevance.
+     * Search specifically within journalist names. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     name?: string;
     /**
-     * Searches for journalists by (exact match) twitter handle.
+     * Filter journalists by their exact Twitter handle, without the @ symbol.
      */
     twitter?: string;
     /**
-     * The number of items per page.
+     * The number of journalists to return per page in the paginated response.
      */
     size?: number;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
     /**
-     * Search for journalist by the publisher\&#39;s domain can include a subdomain. If multiple parameters are passed, they will be applied as OR operations. Wildcards (* and ?) are suported (e.g. *.cnn.com).
+     * Filter journalists by the publisher domains they write for. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an OR filter.
      */
     source?: Array<string>;
     /**
-     * Searches for journalists by topic.
+     * Filter journalists by the topics they frequently cover. Multiple values create an OR filter to find journalists covering any of the specified topics.
      */
     topic?: Array<string>;
     /**
-     * Filter by categories. Categories are general themes that the article is about. Examples of categories: Tech, Politics, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter journalists by the content categories they typically write about (e.g., Politics, Tech, Sports, Business). Multiple values create an OR filter.
      */
     category?: Array<string>;
     /**
-     * Filter journalists by label. For example, searching \&#39;Opinion\&#39; will return the journalists where \&#39;Opinion\&#39;-type articles is one of the top labels for the articles they publish.
+     * Filter journalists by the type of content they typically produce (e.g., Opinion, Paid-news, Non-news). Multiple values create an OR filter.
      */
     label?: Array<string>;
     /**
-     * Returns the journalists with the minimum indicated number of average monthly posts.
+     * Filter for journalists who publish at least this many articles per month. Used to identify more active journalists.
      */
     minMonthlyPosts?: number;
     /**
-     * Returns the journalist with the maximum indicated number of average monthly posts.
+     * Filter for journalists who publish no more than this many articles per month.
      */
     maxMonthlyPosts?: number;
     /**
-     * Country code to filter by country. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter journalists by countries they commonly cover in their reporting. Uses ISO 3166-1 alpha-2 two-letter country codes in lowercase (e.g., us, gb, jp). Multiple values create an OR filter.
      */
     country?: Array<string>;
     /**
-     * Starting date when the record was last updated.
+     * Filter for journalist profiles updated on or after this date. Accepts ISO 8601 format (e.g., 2023-03-01T00:00:00) or yyyy-mm-dd format.
      */
     updatedAtFrom?: Date;
     /**
-     * Ending date when the record was last updated.
+     * Filter for journalist profiles updated on or before this date. Accepts ISO 8601 format (e.g., 2023-03-01T23:59:59) or yyyy-mm-dd format.
      */
     updatedAtTo?: Date;
     /**
-     * If \&#39;true\&#39;, shows accurate number of results matched by the query. By default, the counter is accurate only up to 10,000 results due performance reasons.
+     * Controls whether to return the exact result count. When false (default), counts are capped at 10,000 for performance reasons. Set to true for precise counts in smaller result sets.
      */
     showNumResults?: boolean;
 }
 interface SearchPeopleRequest {
     /**
-     * Search by name of the person. Supports exact matching with quotes (\&quot;\&quot;) and Boolean operators (AND, OR, NOT).
+     * Search by person\&#39;s name. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     name?: string;
     /**
-     * Filter by Wikidata entity ID(s). Use this to find specific people by their Wikidata identifiers.
+     * Filter by Wikidata entity IDs (e.g., Q7747, Q937). These are unique identifiers from Wikidata.org that precisely identify public figures and eliminate name ambiguity. Multiple values create an OR filter.
      */
     wikidataId?: Array<string>;
     /**
-     * Filter by Wikidata occupation ID(s). Use this to find people with specific occupations.
+     * Filter by Wikidata occupation IDs (e.g., Q82955 for politician, Q33999 for actor, Q19546 for businessman). Finds people with specific professions. Multiple values create an OR filter.
      */
     occupationId?: Array<string>;
     /**
-     * Search by occupation name. Supports exact matching with quotes (\&quot;\&quot;) and Boolean operators (AND, OR, NOT).
+     * Search by occupation name (e.g., politician, actor, CEO, athlete). Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     occupationLabel?: string;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
     /**
-     * The number of items per page.
+     * The number of people to return per page in the paginated response.
      */
     size?: number;
 }
 interface SearchSourcesRequest {
     /**
-     * Domain name for the media source to lookup. This parameter supports wildcard queries, ie. \&quot;*.cnn.com\&quot; will match all subdomains for cnn.com.
+     * Filter by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com, us?.nytimes.com). Multiple values create an OR filter.
      */
     domain?: Array<string>;
     /**
-     * Search by name of source. This parameter supports complex boolean search operators, and also searches the altNames field for alternative names of the source.
+     * Search by source name or alternative names. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     name?: string;
     /**
-     * Find all sources within a sourceGroup. Find Source Groups in the guided part of our documentation...
+     * Filter by predefined publisher bundles (e.g., top100, top50tech). Returns all sources within the specified group. See documentation for available source groups.
      */
     sourceGroup?: string;
     /**
-     * Use \&#39;relevance\&#39; to sort by relevance to the query, \&#39;globalRank\&#39; for top ranked sources based on popularity, \&#39;monthlyVisits\&#39; for sources with the largest audience, \&#39;avgMonthlyPosts\&#39; for sources with the highest publishing frequency. Defaults to \&#39;relevance\&#39;.
+     * Determines the source sorting order. Options include relevance (default, best match to query), globalRank (by overall traffic and popularity), monthlyVisits (by total monthly visitor count), and avgMonthlyPosts (by number of articles published monthly).
      */
     sortBy?: SortBy;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
     /**
-     * The number of items per page.
+     * The number of sources to return per page in the paginated response.
      */
     size?: number;
     /**
-     * Filter by popularity. Enter a minimum number of monthly visits that the source must have in order to match your query.
+     * Filter for sources with at least this many monthly visitors. Used to target publishers by audience size.
      */
     minMonthlyVisits?: number;
     /**
-     * Enter a maximum number of monthly visits that the source must have in order to match your query.
+     * Filter for sources with no more than this many monthly visitors. Used to target publishers by audience size.
      */
     maxMonthlyVisits?: number;
     /**
-     * Returns the sources that have at least this number of average monthly posts.
+     * Filter for sources that publish at least this many articles per month. Used to target publishers by content volume.
      */
     minMonthlyPosts?: number;
     /**
-     * Returns the sources that have at most this number of average monthly posts.
+     * Filter for sources that publish no more than this many articles per month. Used to target publishers by content volume.
      */
     maxMonthlyPosts?: number;
     /**
-     * Country code to filter sources by the countries in which they most commonly cover. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter sources by countries they commonly cover in their reporting. Uses ISO 3166-1 alpha-2 two-letter country codes in lowercase (e.g., us, gb, jp). See documentation for supported country codes. Multiple values create an OR filter.
      */
     country?: Array<string>;
     /**
-     * Find all local publications that are located within a given country.
+     * Filter for local publications based in specific countries. Uses ISO 3166-1 alpha-2 two-letter country codes in lowercase (e.g., us, gb, jp). See documentation for supported country codes. Multiple values create an OR filter.
      */
     sourceCountry?: Array<string>;
     /**
-     * Find all local publications that are located within a given state.
+     * Filter for local publications based in specific states or regions. Uses standard two-letter state codes in lowercase (e.g., ca, ny, tx). See documentation for supported state codes. Multiple values create an OR filter.
      */
     sourceState?: Array<string>;
     /**
-     * Find all local publications that are located within a given county.
+     * Filter for local publications based in specific counties. Multiple values create an OR filter.
      */
     sourceCounty?: Array<string>;
     /**
-     * Find all local publications that are located within a given city.
+     * Filter for local publications based in specific cities. Multiple values create an OR filter.
      */
     sourceCity?: Array<string>;
     /**
-     * Latitude of the center point to search local publications.
+     * Latitude coordinate for filtering local publications by geographic proximity. Used with sourceLon and sourceMaxDistance for radius search.
      */
     sourceLat?: number;
     /**
-     * Longitude of the center point to search local publications.
+     * Longitude coordinate for filtering local publications by geographic proximity. Used with sourceLat and sourceMaxDistance for radius search.
      */
     sourceLon?: number;
     /**
-     * Maximum distance from starting point to search local publications.
+     * Maximum distance in kilometers from the coordinates defined by sourceLat and sourceLon. Defines the radius for local publication searches.
      */
     sourceMaxDistance?: number;
     /**
-     * Filter by categories. Categories are general themes that the article is about. Examples of categories: Tech, Politics, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter sources by their primary content categories such as Politics, Tech, Sports, Business, or Finance. Returns sources that frequently cover these topics. Multiple values create an OR filter.
      */
     category?: Array<string>;
     /**
-     * Find sources by topic. For example, searching \&#39;Markets\&#39; will return the sources where \&#39;Markets\&#39; is one of the top 10 topics that they cover.
+     * Filter sources by their frequently covered topics (e.g., Markets, Cryptocurrency, Climate Change). Returns sources where the specified topic is among their top 10 covered areas. Multiple values create an OR filter.
      */
     topic?: Array<string>;
     /**
-     * Filter sources by label. For example, searching \&#39;Opinion\&#39; will return the sources where \&#39;Opinion\&#39;-type articles is one of the top labels for the articles they publish.
+     * Filter sources by their content label patterns (e.g., Opinion, Paid-news, Non-news). Returns sources where the specified label is common in their published content. See documentation for all available labels. Multiple values create an OR filter.
      */
     label?: Array<string>;
     /**
-     * Use \&#39;true\&#39; to find only sources known to have a paywall, or use \&#39;false\&#39; to filter for only sources that do not have a paywall.
+     * Filter by paywall status. Set to true to find sources with paywalls, or false to find sources without paywalls.
      */
     paywall?: boolean;
     /**
-     * Controls whether subdomains are included in the response. When set to true (default), all relevant subdomains of media sources will be returned as separate results. Set to false to consolidate results to parent domains only.
+     * Controls whether subdomains are included as separate results. When true (default), subdomains appear as distinct sources. When false, results are consolidated to parent domains only.
      */
     showSubdomains?: boolean;
     /**
-     * If \&#39;true\&#39;, shows accurate number of results matched by the query. By default, the counter is accurate only up to 10,000 results due performance reasons.
+     * Controls whether to return the exact result count. When false (default), counts are capped at 10,000 for performance reasons. Set to true for precise counts in smaller result sets.
      */
     showNumResults?: boolean;
 }
 interface SearchStoriesRequest {
     /**
-     * Search story by name, summary and key points. Preference is given to the name field. Supports complex query syntax, same way as q parameter from /all endpoint.
+     * Primary search query for filtering stories based on their name, summary, and key points. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     q?: string;
     /**
-     * Search story by name. Supports complex query syntax, same way as q parameter from /all endpoint.
+     * Search specifically within story names. Supports Boolean operators, exact phrases with quotes, and wildcards for matching name variations.
      */
     name?: string;
     /**
-     * Filter to specific story. Passing a cluster ID will filter results to only the content found within the cluster. Multiple params could be passed.
+     * Filter to specific stories using their unique identifiers. Each clusterId represents a distinct story that groups related articles. Multiple values create an OR filter.
      */
     clusterId?: Array<string>;
     /**
-     * Sort stories by count (\&#39;count\&#39;), total count (\&#39;totalCount\&#39;), creation date (\&#39;createdAt\&#39;), last updated date (\&#39;updatedAt\&#39;), or relevance (\&#39;relevance\&#39;). By default is sorted by \&#39;createdAt\&#39;
+     * Excludes specific stories from the results by their unique identifiers. Use this parameter to filter out unwanted or previously seen stories.
+     */
+    excludeClusterId?: Array<string>;
+    /**
+     * Determines the story sorting order. Options include createdAt (default, when stories first emerged), updatedAt (when stories received new articles, best for tracking developing events), relevance (best match to query), count (by unique article count), and totalCount (by total article count including reprints).
      */
     sortBy?: SortBy;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
     /**
-     * The number of items per page.
+     * The number of articles to return per page in the paginated response.
      */
     size?: number;
     /**
@@ -5269,23 +5255,39 @@ interface SearchStoriesRequest {
      */
     to?: Date;
     /**
-     * Filter by topics. Each topic is some kind of entity that the article is about. Examples of topics: Markets, Joe Biden, Green Energy, Climate Change, Cryptocurrency, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter for stories created after this date. Alternative parameter for filtering by story creation date.
+     */
+    initializedFrom?: Date;
+    /**
+     * Filter for stories created before this date. Alternative parameter for filtering by story creation date.
+     */
+    initializedTo?: Date;
+    /**
+     * Filter for stories that received new articles after this date. Useful for tracking developing news events or evolving storylines.
+     */
+    updatedFrom?: Date;
+    /**
+     * Filter for stories that received new articles before this date. Useful for tracking developing news events or evolving storylines.
+     */
+    updatedTo?: Date;
+    /**
+     * Filter stories by specific topics such as Markets, Crime, Cryptocurrency, or College Sports. Topics are more granular than categories, and stories can include multiple topics based on their constituent articles. Use the /topics endpoint for a complete list of available topics. Multiple values create an OR filter.
      */
     topic?: Array<string>;
     /**
-     * Filter by categories. Categories are general themes that the article is about. Examples of categories: Tech, Politics, etc. If multiple parameters are passed, they will be applied as OR operations. Use \&#39;none\&#39; to search uncategorized articles. More ➜
+     * Filter stories by broad content categories such as Politics, Tech, Sports, Business, or Finance. Use \&#39;none\&#39; to find uncategorized stories. Categories are derived from the articles within each story. Multiple values create an OR filter.
      */
     category?: Array<string>;
     /**
-     * Filters by Google Content Categories. This field will accept 1 or more categories, must pass the full name of the category. Example: taxonomy&#x3D;/Finance/Banking/Other, /Finance/Investing/Funds
+     * Filter stories by Google Content Categories. Must pass the full hierarchical path of the category. Example: taxonomy&#x3D;/Finance/Banking/Other,/Finance/Investing/Funds. Stories are categorized based on their constituent articles. Multiple values create an OR filter.
      */
     taxonomy?: Array<string>;
     /**
-     * Filter stories by sources that wrote articles belonging to this story. At least 1 article is required for story to match. Multiple parameters could be passed.
+     * Filter stories that contain articles from specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). A story will match if it contains at least one article from any of the specified sources. Multiple values create an OR filter.
      */
     source?: Array<string>;
     /**
-     * Filter stories by sources that wrote articles belonging to this story. Source groups are expanded into a list of sources. At least 1 article by the source is required for story to match. Multiple params could be passed.
+     * Filter stories that contain articles from publishers in Perigon\&#39;s curated bundles (e.g., top100, top25crypto). A story will match if it contains at least one article from any publisher in the specified bundles. Multiple values create an OR filter.
      */
     sourceGroup?: Array<string>;
     /**
@@ -5293,27 +5295,27 @@ interface SearchStoriesRequest {
      */
     minUniqueSources?: number;
     /**
-     * List of person Wikidata IDs for filtering. Filter is applied on topPeople field.
+     * Filter stories by Wikidata IDs of top mentioned people. Returns stories where these individuals appear prominently. Refer to the /people endpoint for a complete list of tracked individuals.
      */
     personWikidataId?: Array<string>;
     /**
-     * List of people names. Filtering is applied on topPeople field.
+     * Filter stories by exact name matches of top mentioned people. Does not support Boolean or complex logic. For available person entities, consult the /people endpoint.
      */
     personName?: string;
     /**
-     * List of company IDs for filtering. Filtering is applied to topCompanies field.
+     * Filter stories by identifiers of top mentioned companies. Returns stories where these companies appear prominently. For a complete list of tracked companies, refer to the /companies endpoint.
      */
     companyId?: Array<string>;
     /**
-     * List of company names for filtering. Filtering is applied on topCompanies field.
+     * Filter stories by names of top mentioned companies. Performs an exact match on company names in the topCompanies field.
      */
     companyName?: string;
     /**
-     * List of company domains for filtering. Filtering is applied on topCompanies field.
+     * Filter stories by domains of top mentioned companies (e.g., apple.com). Returns stories where companies with these domains appear prominently. For available company entities, consult the /companies endpoint.
      */
     companyDomain?: Array<string>;
     /**
-     * List of company tickers for filtering. Filtering is applied on topCompanies field.
+     * Filter stories by stock symbols of top mentioned companies. Returns stories where companies with these symbols appear prominently. For available company entities and their symbols, consult the /companies endpoint.
      */
     companySymbol?: Array<string>;
     /**
@@ -5341,49 +5343,33 @@ interface SearchStoriesRequest {
      */
     maxClusterSize?: number;
     /**
-     * Returns stories with name assigned. Defaults to true.
+     * Filter to only include stories that have been assigned names. Defaults to true. Note that stories only receive names after they contain at least 5 unique articles.
      */
     nameExists?: boolean;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating positive sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with an aggregate positive sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone.
      */
     positiveSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating positive sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with an aggregate positive sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone.
      */
     positiveSentimentTo?: number;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating neutral sentiment. Explanation of sentimental values can be found in Docs under the Article Data section.
+     * Filter articles with an aggregate neutral sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone.
      */
     neutralSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating neutral sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with an aggregate neutral sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone.
      */
     neutralSentimentTo?: number;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating negative sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter stories with an aggregate negative sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone.
      */
     negativeSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating negative sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with an aggregate negative sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone.
      */
     negativeSentimentTo?: number;
-    /**
-     * \&#39;initializedFrom\&#39; filter, will search stories that became available after provided date
-     */
-    initializedFrom?: Date;
-    /**
-     * \&#39;initializedTo\&#39; filter, will search stories that became available before provided date
-     */
-    initializedTo?: Date;
-    /**
-     * Will return stories with \&#39;updatedAt\&#39; &gt;&#x3D; \&#39;updatedFrom\&#39;.
-     */
-    updatedFrom?: Date;
-    /**
-     * Will return stories with \&#39;updatedAt\&#39; &lt;&#x3D; \&#39;updatedTo\&#39;.
-     */
-    updatedTo?: Date;
     /**
      * Parameter showStoryPageInfo
      */
@@ -5396,10 +5382,6 @@ interface SearchStoriesRequest {
      * Stories are deduplicated by default. If a story is deduplicated, all future articles are merged into the original story. duplicateOf field contains the original cluster Id. When showDuplicates&#x3D;true, all stories are shown.
      */
     showDuplicates?: boolean;
-    /**
-     * Excludes specific stories from the results by their unique identifiers. Use this parameter to filter out unwanted or previously seen stories.
-     */
-    excludeClusterId?: Array<string>;
 }
 interface SearchSummarizerRequest {
     /**
@@ -5408,87 +5390,87 @@ interface SearchSummarizerRequest {
      */
     summaryBody: SummaryBody;
     /**
-     * Search query, each article will be scored and ranked against it. Articles are searched on the title, description, and content fields.
+     * Primary search query for filtering articles based on their title, description, and content. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
      */
     q?: string;
     /**
-     * Search article headlines/title field. Semantic similar to q parameter.
+     * Search specifically within article headlines/titles. Supports Boolean operators, exact phrases with quotes, and wildcards for matching title variations.
      */
     title?: string;
     /**
-     * Search query on the description field. Semantic similar to q parameter.
+     * Search within article description fields. Supports Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching.
      */
     desc?: string;
     /**
-     * Search query on the article\&#39;s body of content field. Semantic similar to q parameter.
+     * Search within the full article body content. Supports Boolean logic, exact phrase matching with quotes, and wildcards for comprehensive content searching.
      */
     content?: string;
     /**
-     * Search query on the url field. Semantic similar to q parameter. E.g. could be used for querying certain website sections, e.g. source&#x3D;cnn.com&amp;url&#x3D;travel.
+     * Search within article URLs to find content from specific website sections or domains. Supports wildcards (* and ?) for partial URL matching.
      */
     url?: string;
     /**
-     * Article ID will search for a news article by the ID of the article. If several parameters are passed, all matched articles will be returned.
+     * Retrieve specific news articles by their unique article identifiers. Multiple IDs can be provided to return a collection of specific articles.
      */
     articleId?: Array<string>;
     /**
-     * Search for related content using a cluster ID. Passing a cluster ID will filter results to only the content found within the cluster.
+     * Filter results to only show content within a specific related content cluster. Returns articles grouped together as part of Perigon Stories based on topic relevance.
      */
     clusterId?: Array<string>;
     /**
-     * \&#39;relevance\&#39; to sort by relevance to the query, \&#39;date\&#39; to sort by the publication date (desc), \&#39;pubDate\&#39; is a synonym to \&#39;date\&#39;, \&#39;addDate\&#39; to sort by \&#39;addDate\&#39; field (desc), \&#39;refreshDate\&#39; to sort by \&#39;refreshDate\&#39; field (desc). Defaults to \&#39;relevance\&#39;
+     * Determines the article sorting order. Options include relevance (default), date/pubDate (newest publication date first), reverseDate (oldest publication date first), addDate (newest ingestion date first), reverseAddDate (oldest ingestion date first), and refreshDate (most recently updated in system first, often identical to addDate).
      */
     sortBy?: AllEndpointSortBy;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
     /**
-     * The number of items per page.
+     * The number of articles to return per page in the paginated response.
      */
     size?: number;
     /**
-     * \&#39;from\&#39; filter, will search articles published after the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2023-03-01T00:00:00
+     * Filter for articles published after this date. Accepts ISO 8601 format (e.g., 2023-03-01T00:00:00) or yyyy-mm-dd format.
      */
     from?: Date;
     /**
-     * \&#39;to\&#39; filter, will search articles published before the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T23:59:59
+     * Filter for articles published before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.
      */
     to?: Date;
     /**
-     * \&#39;addDateFrom\&#39; filter, will search articles added after the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T00:00:00
+     * Filter for articles added to Perigon\&#39;s system after this date. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or yyyy-mm-dd format.
      */
     addDateFrom?: Date;
     /**
-     * \&#39;addDateTo\&#39; filter, will search articles added before the specified date, the date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T23:59:59
+     * Filter for articles added to Perigon\&#39;s system before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.
      */
     addDateTo?: Date;
     /**
-     * Will search articles that were refreshed after the specified date. The date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T00:00:00
+     * Filter for articles refreshed/updated in Perigon\&#39;s system after this date. In most cases yields similar results to addDateFrom but can differ for updated content. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or yyyy-mm-dd format.
      */
     refreshDateFrom?: Date;
     /**
-     * Will search articles that were refreshed before the specified date. The date could be passed as ISO or \&#39;yyyy-mm-dd\&#39;. Add time in ISO format, ie. 2022-02-01T23:59:59
+     * Filter for articles refreshed/updated in Perigon\&#39;s system before this date. In most cases yields similar results to addDateTo but can differ for updated content. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.
      */
     refreshDateTo?: Date;
     /**
-     * Medium will filter out news articles medium, which could be \&#39;Video\&#39; or \&#39;Article\&#39;. If several parameters are passed, all matched articles will be returned.
+     * Filter articles by their primary medium type. Accepts Article for written content or Video for video-based stories. Multiple values create an OR filter.
      */
     medium?: Array<string>;
     /**
-     * Publisher\&#39;s domain can include a subdomain. If multiple parameters are passed, they will be applied as OR operations. Wildcards (* and ?) are suported (e.g. *.cnn.com).
+     * Filter articles by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an OR filter.
      */
     source?: Array<string>;
     /**
-     * One of the supported source groups. Find Source Groups in the guided part of our documentation...
+     * Filter articles using Perigon\&#39;s curated publisher bundles (e.g., top100, top25crypto). Multiple values create an OR filter to include articles from any of the specified bundles.
      */
     sourceGroup?: Array<string>;
     /**
-     * A list of built-in source group names to exclude from the results. The Perigon API categorizes sources into groups (for example, “top10” or “top100”) based on type or popularity. Using this filter allows you to remove articles coming from any source that belongs to one or more of the specified groups.
+     * Exclude articles from specified Perigon source groups. Multiple values create an AND-exclude filter, removing content from publishers in any of the specified bundles (e.g., top10, top100).
      */
     excludeSourceGroup?: Array<string>;
     /**
-     * The domain of the website, which should be excluded from the search. Multiple parameters could be provided. Wildcards (* and ?) are suported (e.g. *.cnn.com).
+     * Exclude articles from specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an AND-exclude filter.
      */
     excludeSource?: Array<string>;
     /**
@@ -5496,71 +5478,71 @@ interface SearchSummarizerRequest {
      */
     paywall?: boolean;
     /**
-     * Author names to filter by. Article author bylines are used as a source field. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles by author bylines. Works as an exact match for each author name provided. Multiple values create an OR filter to find articles by any of the specified authors.
      */
     byline?: Array<string>;
     /**
-     * A list of author names to include. Only articles written by any of the specified authors are returned. This is ideal when you wish to focus on content from particular voices or experts.
+     * Filter articles by specific author names. Works as an exact match for each name. Multiple values create an OR filter to find articles by any of the specified authors.
      */
     author?: Array<string>;
     /**
-     *  A list of author names to exclude from the search results. Any article written by an author whose name matches one in this list will be omitted, which helps to avoid content from certain individuals.
+     * Exclude articles written by specific authors. Any article with an author name matching an entry in this list will be omitted from results. Multiple values create an AND-exclude filter.
      */
     excludeAuthor?: Array<string>;
     /**
-     * Filter by journalist ID. Journalist IDs are unique journalist identifiers which can be found through the Journalist API, or in the matchedAuthors field.
+     * Filter by unique journalist identifiers which can be found through the Journalist API or in the matchedAuthors field. Multiple values create an OR filter.
      */
     journalistId?: Array<string>;
     /**
-     * A list of journalist (or reporter) identifiers to exclude. If an article is written by a journalist whose ID matches any in this list, it will not be part of the result set.
+     * Exclude articles written by specific journalists identified by their unique IDs. Multiple values create an AND-exclude filter.
      */
     excludeJournalistId?: Array<string>;
     /**
-     * Language code to filter by language. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles by their language using ISO-639 two-letter codes (e.g., en, es, fr). Multiple values create an OR filter.
      */
     language?: Array<string>;
     /**
-     *  A list of languages to be excluded. Any article published in one of the languages provided in this filter will not be returned. This is useful when you are interested only in news published in specific languages.
+     * Exclude articles in specific languages using ISO-639 two-letter codes. Multiple values create an AND-exclude filter.
      */
     excludeLanguage?: Array<string>;
     /**
-     * Expand a query to search the translation, translatedTitle, and translatedDescription fields for non-English articles.
+     * Expand search to include translated content fields for non-English articles. When true, searches translated title, description, and content fields.
      */
     searchTranslation?: boolean;
     /**
-     * Labels to filter by, could be \&#39;Opinion\&#39;, \&#39;Paid-news\&#39;, \&#39;Non-news\&#39;, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Filter articles by editorial labels such as Opinion, Paid-news, Non-news, Fact Check, or Press Release. Multiple values create an OR filter.
      */
     label?: Array<string>;
     /**
-     * Exclude results that include specific labels (Opinion, Non-news, Paid News, etc.). You can filter multiple by repeating the parameter.
+     * Exclude articles with specific editorial labels. Multiple values create an AND-exclude filter, removing all content with any of these labels.
      */
     excludeLabel?: Array<string>;
     /**
-     * Filter by categories. Categories are general themes that the article is about. Examples of categories: Tech, Politics, etc. If multiple parameters are passed, they will be applied as OR operations. Use \&#39;none\&#39; to search uncategorized articles.
+     * Filter by broad content categories such as Politics, Tech, Sports, Business, or Finance. Use \&#39;none\&#39; to find uncategorized articles. Multiple values create an OR filter.
      */
     category?: Array<string>;
     /**
-     * A list of article categories to be omitted. If an article is tagged with any category present in this list (such as “Polotics”, “Tech”, “Sports”, etc.), it will not appear in the search results.
+     * Exclude articles with specific categories. Multiple values create an AND-exclude filter, removing all content with any of these categories.
      */
     excludeCategory?: Array<string>;
     /**
-     * Filters results to include only articles with the specified topics. Topics are more specific classifications than categories, with an article potentially having multiple topics assigned. Perigon uses both human and machine curation to maintain an evolving list of available topics. Common examples include \&#39;Markets\&#39;, \&#39;Crime\&#39;, \&#39;Cryptocurrency\&#39;, \&#39;Social Issues\&#39;, \&#39;College Sports\&#39;, etc. See the Topics page in Docs for a complete list of available topics.
+     * Filter by specific topics such as Markets, Crime, Cryptocurrency, or College Sports. Topics are more granular than categories, and articles can have multiple topics. Use the /topics endpoint for a complete list of available topics. Multiple values create an OR filter.
      */
     topic?: Array<string>;
     /**
-     * Filter by excluding topics. Each topic is some kind of entity that the article is about. Examples of topics: Markets, Joe Biden, Green Energy, Climate Change, Cryptocurrency, etc. If multiple parameters are passed, they will be applied as OR operations.
+     * Exclude articles with specific topics. Multiple values create an AND-exclude filter, removing all content with any of these topics.
      */
     excludeTopic?: Array<string>;
     /**
-     * Returns only articles that point to specified links (as determined by the \&#39;links\&#39; field in the article response).
+     * Returns only articles that contain links to the specified URL pattern. Matches against the \&#39;links\&#39; field in article responses.
      */
     linkTo?: string;
     /**
-     * Whether to return reprints in the response or not. Reprints are usually wired articles from sources like AP or Reuters that are reprinted in multiple sources at the same time. By default, this parameter is \&#39;true\&#39;.
+     * Controls whether to include reprinted content in results. When true (default), shows syndicated articles from wire services like AP or Reuters that appear on multiple sites.
      */
     showReprints?: boolean;
     /**
-     * Shows all articles belonging to the same reprint group. A reprint group includes one original article (the first one processed by the API) and all its known reprints.
+     * Returns all articles in a specific reprint group, including the original article and all its known reprints. Use when you want to see all versions of the same content.
      */
     reprintGroupId?: string;
     /**
@@ -5648,43 +5630,43 @@ interface SearchSummarizerRequest {
      */
     sourceMaxDistance?: number;
     /**
-     * List of person Wikidata IDs for filtering.
+     * Filter articles by Wikidata IDs of mentioned people. Refer to the /people endpoint for a complete list of tracked individuals.
      */
     personWikidataId?: Array<string>;
     /**
-     * A list of Wikidata identifiers for individuals. Articles mentioning persons with any of these Wikidata IDs will be filtered out. This is particularly helpful when using a unique identifier to prevent ambiguity in names.
+     * Exclude articles mentioning people with specific Wikidata IDs. Creates an AND-exclude filter to remove content about these individuals. Uses precise identifiers to avoid name ambiguity.
      */
     excludePersonWikidataId?: Array<string>;
     /**
-     * List of person names for exact matches. Boolean and complex logic is not supported on this paramter.
+     * Filter articles by exact person name matches. Does not support Boolean or complex logic. For available person entities, consult the /people endpoint.
      */
     personName?: Array<string>;
     /**
-     * A list of person names that, when associated with the content, cause the article to be excluded. This filter removes articles related to any individuals whose names match those on the list.
+     * Exclude articles mentioning specific people by name. Creates an AND-exclude filter to remove content about these individuals.
      */
     excludePersonName?: Array<string>;
     /**
-     * List of company IDs to filter by.
+     * Filter articles by company identifiers. For a complete list of tracked companies, refer to the /companies endpoint.
      */
     companyId?: Array<string>;
     /**
-     * A list of company identifiers. Articles associated with companies that have any of these unique IDs will be filtered out from the returned results, ensuring that certain companies or corporate entities are not included.
+     * Exclude articles mentioning companies with specific identifiers. Creates an AND-exclude filter to remove content about these corporate entities.
      */
     excludeCompanyId?: Array<string>;
     /**
-     * Search by company name.
+     * Filter articles by company name mentions. Performs an exact match on company names.
      */
     companyName?: string;
     /**
-     * Search by company domains for filtering. E.g. companyDomain&#x3D;apple.com.
+     * Filter articles by company domains (e.g., apple.com). For available company entities, consult the /companies endpoint.
      */
     companyDomain?: Array<string>;
     /**
-     * A list of company domains to exclude. If an article is related to a company that uses one of the specified domains (for instance, “example.com”), it will not be returned in the results.
+     * Exclude articles related to companies with specific domains. Creates an AND-exclude filter to remove content about these companies.
      */
     excludeCompanyDomain?: Array<string>;
     /**
-     * Search by company symbols.
+     * Filter articles by company stock symbols. For available company entities and their symbols, consult the /companies endpoint.
      */
     companySymbol?: Array<string>;
     /**
@@ -5696,31 +5678,31 @@ interface SearchSummarizerRequest {
      */
     showNumResults?: boolean;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating positive sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a positive sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone.
      */
     positiveSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating positive sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a positive sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger positive tone.
      */
     positiveSentimentTo?: number;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating neutral sentiment. Explanation of sentimental values can be found in Docs under the Article Data section.
+     * Filter articles with a neutral sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone.
      */
     neutralSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating neutral sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a neutral sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger neutral tone.
      */
     neutralSentimentTo?: number;
     /**
-     * Filters results with a sentiment score greater than or equal to the specified value, indicating negative sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a negative sentiment score greater than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone.
      */
     negativeSentimentFrom?: number;
     /**
-     * Filters results with a sentiment score less than or equal to the specified value, indicating negative sentiment. See the Article Data section in Docs for an explanation of scores.
+     * Filter articles with a negative sentiment score less than or equal to the specified value. Scores range from 0 to 1, with higher values indicating stronger negative tone.
      */
     negativeSentimentTo?: number;
     /**
-     * Filters by Google Content Categories. This field will accept 1 or more categories, must pass the full name of the category. Example: taxonomy&#x3D;/Finance/Banking/Other, /Finance/Investing/Funds
+     * Filters by Google Content Categories. This field will accept 1 or more categories, must pass the full name of the category. Example: taxonomy&#x3D;/Finance/Banking/Other, /Finance/Investing/Funds. [Full list](https://cloud.google.com/natural-language/docs/categories)
      */
     taxonomy?: Array<string>;
     /**
@@ -5730,23 +5712,23 @@ interface SearchSummarizerRequest {
 }
 interface SearchTopicsRequest {
     /**
-     * Search by name.
+     * Search for topics by exact name or partial text match. Does not support wildcards. Examples include Markets, Cryptocurrency, Climate Change, etc.
      */
     name?: string;
     /**
-     * Search by category.
+     * Filter topics by broad article categories such as Politics, Tech, Sports, Business, Finance, Entertainment, etc.
      */
     category?: string;
     /**
-     * Search by subcategory.
+     * Filter topics by their specific subcategory. Subcategories provide more granular classification beyond the main category, such as TV or Event.
      */
     subcategory?: string;
     /**
-     * The page number to retrieve.
+     * The specific page of results to retrieve in the paginated response. Starts at 0.
      */
     page?: number;
     /**
-     * The number of items per page.
+     * The number of topics to return per page in the paginated response.
      */
     size?: number;
 }
@@ -5818,12 +5800,12 @@ interface V1ApiInterface {
      * @throws {RequiredError}
      * @memberof V1ApiInterface
      */
-    searchJournalists1Raw(requestParameters: SearchJournalists1Request, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<JournalistSearchResult>>;
+    searchJournalistsRaw(requestParameters: SearchJournalistsRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<JournalistSearchResult>>;
     /**
      * Search journalists using broad search attributes. Our database contains over 230,000 journalists from around the world and is refreshed frequently.
      * Journalists
      */
-    searchJournalists1(requestParameters: SearchJournalists1Request, initOverrides?: RequestInit | InitOverrideFunction): Promise<JournalistSearchResult>;
+    searchJournalists(requestParameters: SearchJournalistsRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<JournalistSearchResult>;
     /**
      * Search and retrieve additional information on known persons that exist within Perigon\'s entity database and as referenced in any article response object. Our database contains over 650,000 people from around the world and is refreshed frequently. People data is derived from Wikidata and includes a wikidataId field that can be used to lookup even more information on Wikidata\'s website.
      * @summary People
@@ -5953,12 +5935,12 @@ declare class V1Api extends BaseAPI implements V1ApiInterface {
      * Search journalists using broad search attributes. Our database contains over 230,000 journalists from around the world and is refreshed frequently.
      * Journalists
      */
-    searchJournalists1Raw(requestParameters: SearchJournalists1Request, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<JournalistSearchResult>>;
+    searchJournalistsRaw(requestParameters: SearchJournalistsRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<JournalistSearchResult>>;
     /**
      * Search journalists using broad search attributes. Our database contains over 230,000 journalists from around the world and is refreshed frequently.
      * Journalists
      */
-    searchJournalists1(requestParameters?: SearchJournalists1Request, initOverrides?: RequestInit | InitOverrideFunction): Promise<JournalistSearchResult>;
+    searchJournalists(requestParameters?: SearchJournalistsRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<JournalistSearchResult>;
     /**
      * Search and retrieve additional information on known persons that exist within Perigon\'s entity database and as referenced in any article response object. Our database contains over 650,000 people from around the world and is refreshed frequently. People data is derived from Wikidata and includes a wikidataId field that can be used to lookup even more information on Wikidata\'s website.
      * People
@@ -6021,4 +6003,4 @@ declare class V1Api extends BaseAPI implements V1ApiInterface {
     vectorSearchArticles(requestParameters: VectorSearchArticlesRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<VectorSearchResult>;
 }
 
-export { AllEndpointSortBy, AllEndpointSortByFromJSON, AllEndpointSortByFromJSONTyped, AllEndpointSortByToJSON, AllEndpointSortByToJSONTyped, type ApiResponse, type Article, ArticleFromJSON, ArticleFromJSONTyped, type ArticleSearchFilter, ArticleSearchFilterFromJSON, ArticleSearchFilterFromJSONTyped, ArticleSearchFilterToJSON, ArticleSearchFilterToJSONTyped, type ArticleSearchParams, ArticleSearchParamsFromJSON, ArticleSearchParamsFromJSONTyped, ArticleSearchParamsToJSON, ArticleSearchParamsToJSONTyped, ArticleToJSON, ArticleToJSONTyped, type AuthException, AuthExceptionFromJSON, AuthExceptionFromJSONTyped, AuthExceptionStatusCodeEnum, AuthExceptionToJSON, AuthExceptionToJSONTyped, BASE_PATH, BaseAPI, BlobApiResponse, COLLECTION_FORMATS, type CategoryHolder, CategoryHolderFromJSON, CategoryHolderFromJSONTyped, CategoryHolderToJSON, CategoryHolderToJSONTyped, type CategoryWithScoreHolder, CategoryWithScoreHolderFromJSON, CategoryWithScoreHolderFromJSONTyped, CategoryWithScoreHolderToJSON, CategoryWithScoreHolderToJSONTyped, type Company, type CompanyCount, CompanyCountFromJSON, CompanyCountFromJSONTyped, CompanyCountToJSON, CompanyCountToJSONTyped, CompanyFromJSON, CompanyFromJSONTyped, type CompanyHolder, CompanyHolderFromJSON, CompanyHolderFromJSONTyped, CompanyHolderToJSON, CompanyHolderToJSONTyped, type CompanySearchResult, CompanySearchResultFromJSON, CompanySearchResultFromJSONTyped, CompanySearchResultToJSON, CompanySearchResultToJSONTyped, CompanyToJSON, CompanyToJSONTyped, Configuration, type ConfigurationParameters, type Consume, type Coordinate, type CoordinateFilter, CoordinateFilterFromJSON, CoordinateFilterFromJSONTyped, CoordinateFilterToJSON, CoordinateFilterToJSONTyped, CoordinateFromJSON, CoordinateFromJSONTyped, CoordinateToJSON, CoordinateToJSONTyped, DefaultConfig, type EntityHolder, EntityHolderFromJSON, EntityHolderFromJSONTyped, EntityHolderToJSON, EntityHolderToJSONTyped, type ErrorContext, type EventTypeHolder, EventTypeHolderFromJSON, EventTypeHolderFromJSONTyped, EventTypeHolderToJSON, EventTypeHolderToJSONTyped, type FetchAPI, FetchError, type FetchParams, type GetJournalistByIdRequest, type HTTPBody, type HTTPHeaders, type HTTPMethod, type HTTPQuery, type HTTPRequestInit, type IdNameHolder, IdNameHolderFromJSON, IdNameHolderFromJSONTyped, IdNameHolderToJSON, IdNameHolderToJSONTyped, type IllegalParameterException, IllegalParameterExceptionFromJSON, IllegalParameterExceptionFromJSONTyped, IllegalParameterExceptionToJSON, IllegalParameterExceptionToJSONTyped, type ImageHolder, ImageHolderFromJSON, ImageHolderFromJSONTyped, ImageHolderToJSON, ImageHolderToJSONTyped, type InitOverrideFunction, type InternalErrorException, InternalErrorExceptionFromJSON, InternalErrorExceptionFromJSONTyped, InternalErrorExceptionToJSON, InternalErrorExceptionToJSONTyped, JSONApiResponse, type Journalist, JournalistFromJSON, JournalistFromJSONTyped, type JournalistSearchResult, JournalistSearchResultFromJSON, JournalistSearchResultFromJSONTyped, JournalistSearchResultToJSON, JournalistSearchResultToJSONTyped, JournalistToJSON, JournalistToJSONTyped, type Json, type KeyPoint, KeyPointFromJSON, KeyPointFromJSONTyped, KeyPointToJSON, KeyPointToJSONTyped, type KeywordHolder, KeywordHolderFromJSON, KeywordHolderFromJSONTyped, KeywordHolderToJSON, KeywordHolderToJSONTyped, type LabelHolder, LabelHolderFromJSON, LabelHolderFromJSONTyped, LabelHolderToJSON, LabelHolderToJSONTyped, type LocationCount, LocationCountFromJSON, LocationCountFromJSONTyped, LocationCountToJSON, LocationCountToJSONTyped, type LocationHolder, LocationHolderFromJSON, LocationHolderFromJSONTyped, LocationHolderToJSON, LocationHolderToJSONTyped, type Middleware, type ModelPropertyNaming, type NameCount, NameCountFromJSON, NameCountFromJSONTyped, NameCountToJSON, NameCountToJSONTyped, type NewsCluster, NewsClusterFromJSON, NewsClusterFromJSONTyped, NewsClusterToJSON, NewsClusterToJSONTyped, type NotFoundException, NotFoundExceptionFromJSON, NotFoundExceptionFromJSONTyped, NotFoundExceptionToJSON, NotFoundExceptionToJSONTyped, type PeopleSearchResult, PeopleSearchResultFromJSON, PeopleSearchResultFromJSONTyped, PeopleSearchResultToJSON, PeopleSearchResultToJSONTyped, type Person, type PersonCount, PersonCountFromJSON, PersonCountFromJSONTyped, PersonCountToJSON, PersonCountToJSONTyped, PersonFromJSON, PersonFromJSONTyped, type PersonHolder, PersonHolderFromJSON, PersonHolderFromJSONTyped, PersonHolderToJSON, PersonHolderToJSONTyped, PersonToJSON, PersonToJSONTyped, type Place, PlaceFromJSON, PlaceFromJSONTyped, PlaceToJSON, PlaceToJSONTyped, type QuerySearchResult, QuerySearchResultFromJSON, QuerySearchResultFromJSONTyped, QuerySearchResultToJSON, QuerySearchResultToJSONTyped, type Question, QuestionFromJSON, QuestionFromJSONTyped, QuestionToJSON, QuestionToJSONTyped, type RecordStatHolder, RecordStatHolderFromJSON, RecordStatHolderFromJSONTyped, RecordStatHolderToJSON, RecordStatHolderToJSONTyped, type RequestContext, type RequestOpts, RequiredError, type ResponseContext, ResponseError, type ResponseTransformer, type ScoredArticle, ScoredArticleFromJSON, ScoredArticleFromJSONTyped, ScoredArticleToJSON, ScoredArticleToJSONTyped, type SearchArticlesRequest, type SearchCompaniesRequest, type SearchJournalists1Request, type SearchPeopleRequest, type SearchSourcesRequest, type SearchStoriesRequest, type SearchSummarizerRequest, type SearchTopicsRequest, type SentimentHolder, SentimentHolderFromJSON, SentimentHolderFromJSONTyped, SentimentHolderToJSON, SentimentHolderToJSONTyped, SortBy, SortByFromJSON, SortByFromJSONTyped, SortByToJSON, SortByToJSONTyped, type Source, SourceFromJSON, SourceFromJSONTyped, type SourceHolder, SourceHolderFromJSON, SourceHolderFromJSONTyped, SourceHolderToJSON, SourceHolderToJSONTyped, type SourceLocation, SourceLocationFromJSON, SourceLocationFromJSONTyped, SourceLocationToJSON, SourceLocationToJSONTyped, type SourceSearchResult, SourceSearchResultFromJSON, SourceSearchResultFromJSONTyped, SourceSearchResultToJSON, SourceSearchResultToJSONTyped, SourceToJSON, SourceToJSONTyped, type SourceTopStatHolder, SourceTopStatHolderFromJSON, SourceTopStatHolderFromJSONTyped, SourceTopStatHolderToJSON, SourceTopStatHolderToJSONTyped, type StorySearchResult, StorySearchResultFromJSON, StorySearchResultFromJSONTyped, StorySearchResultToJSON, StorySearchResultToJSONTyped, type SummaryBody, SummaryBodyFromJSON, SummaryBodyFromJSONTyped, SummaryBodyMethodEnum, SummaryBodyModelEnum, SummaryBodySummarizeFieldsEnum, SummaryBodyToJSON, SummaryBodyToJSONTyped, type SummarySearchResult, SummarySearchResultFromJSON, SummarySearchResultFromJSONTyped, SummarySearchResultToJSON, SummarySearchResultToJSONTyped, type SymbolHolder, SymbolHolderFromJSON, SymbolHolderFromJSONTyped, SymbolHolderToJSON, SymbolHolderToJSONTyped, TextApiResponse, type TooManyRequestsException, type TooManyRequestsExceptionCause, TooManyRequestsExceptionCauseFromJSON, TooManyRequestsExceptionCauseFromJSONTyped, type TooManyRequestsExceptionCauseStackTraceInner, TooManyRequestsExceptionCauseStackTraceInnerFromJSON, TooManyRequestsExceptionCauseStackTraceInnerFromJSONTyped, TooManyRequestsExceptionCauseStackTraceInnerToJSON, TooManyRequestsExceptionCauseStackTraceInnerToJSONTyped, TooManyRequestsExceptionCauseToJSON, TooManyRequestsExceptionCauseToJSONTyped, TooManyRequestsExceptionFromJSON, TooManyRequestsExceptionFromJSONTyped, TooManyRequestsExceptionStatusEnum, type TooManyRequestsExceptionSuppressedInner, TooManyRequestsExceptionSuppressedInnerFromJSON, TooManyRequestsExceptionSuppressedInnerFromJSONTyped, TooManyRequestsExceptionSuppressedInnerToJSON, TooManyRequestsExceptionSuppressedInnerToJSONTyped, TooManyRequestsExceptionToJSON, TooManyRequestsExceptionToJSONTyped, type TopicDto, TopicDtoFromJSON, TopicDtoFromJSONTyped, TopicDtoToJSON, TopicDtoToJSONTyped, type TopicHolder, TopicHolderFromJSON, TopicHolderFromJSONTyped, TopicHolderToJSON, TopicHolderToJSONTyped, type TopicLabels, TopicLabelsFromJSON, TopicLabelsFromJSONTyped, TopicLabelsToJSON, TopicLabelsToJSONTyped, type TopicSearchResult, TopicSearchResultFromJSON, TopicSearchResultFromJSONTyped, TopicSearchResultToJSON, TopicSearchResultToJSONTyped, V1Api, type V1ApiInterface, type VectorSearchArticlesRequest, type VectorSearchResult, VectorSearchResultFromJSON, VectorSearchResultFromJSONTyped, VectorSearchResultToJSON, VectorSearchResultToJSONTyped, VoidApiResponse, type WebResources, WebResourcesFromJSON, WebResourcesFromJSONTyped, WebResourcesToJSON, WebResourcesToJSONTyped, type WikidataDateHolder, WikidataDateHolderFromJSON, WikidataDateHolderFromJSONTyped, WikidataDateHolderToJSON, WikidataDateHolderToJSONTyped, type WikidataLabelHolder, WikidataLabelHolderFromJSON, WikidataLabelHolderFromJSONTyped, WikidataLabelHolderToJSON, WikidataLabelHolderToJSONTyped, type WikidataPoliticalPartyHolder, WikidataPoliticalPartyHolderFromJSON, WikidataPoliticalPartyHolderFromJSONTyped, WikidataPoliticalPartyHolderToJSON, WikidataPoliticalPartyHolderToJSONTyped, type WikidataPositionHolder, WikidataPositionHolderFromJSON, WikidataPositionHolderFromJSONTyped, WikidataPositionHolderToJSON, WikidataPositionHolderToJSONTyped, canConsumeForm, exists, instanceOfAllEndpointSortBy, instanceOfArticle, instanceOfArticleSearchFilter, instanceOfArticleSearchParams, instanceOfAuthException, instanceOfCategoryHolder, instanceOfCategoryWithScoreHolder, instanceOfCompany, instanceOfCompanyCount, instanceOfCompanyHolder, instanceOfCompanySearchResult, instanceOfCoordinate, instanceOfCoordinateFilter, instanceOfEntityHolder, instanceOfEventTypeHolder, instanceOfIdNameHolder, instanceOfIllegalParameterException, instanceOfImageHolder, instanceOfInternalErrorException, instanceOfJournalist, instanceOfJournalistSearchResult, instanceOfKeyPoint, instanceOfKeywordHolder, instanceOfLabelHolder, instanceOfLocationCount, instanceOfLocationHolder, instanceOfNameCount, instanceOfNewsCluster, instanceOfNotFoundException, instanceOfPeopleSearchResult, instanceOfPerson, instanceOfPersonCount, instanceOfPersonHolder, instanceOfPlace, instanceOfQuerySearchResult, instanceOfQuestion, instanceOfRecordStatHolder, instanceOfScoredArticle, instanceOfSentimentHolder, instanceOfSortBy, instanceOfSource, instanceOfSourceHolder, instanceOfSourceLocation, instanceOfSourceSearchResult, instanceOfSourceTopStatHolder, instanceOfStorySearchResult, instanceOfSummaryBody, instanceOfSummarySearchResult, instanceOfSymbolHolder, instanceOfTooManyRequestsException, instanceOfTooManyRequestsExceptionCause, instanceOfTooManyRequestsExceptionCauseStackTraceInner, instanceOfTooManyRequestsExceptionSuppressedInner, instanceOfTopicDto, instanceOfTopicHolder, instanceOfTopicLabels, instanceOfTopicSearchResult, instanceOfVectorSearchResult, instanceOfWebResources, instanceOfWikidataDateHolder, instanceOfWikidataLabelHolder, instanceOfWikidataPoliticalPartyHolder, instanceOfWikidataPositionHolder, mapValues, querystring };
+export { AllEndpointSortBy, AllEndpointSortByFromJSON, AllEndpointSortByFromJSONTyped, AllEndpointSortByToJSON, AllEndpointSortByToJSONTyped, type ApiResponse, type Article, ArticleFromJSON, ArticleFromJSONTyped, type ArticleSearchFilter, ArticleSearchFilterFromJSON, ArticleSearchFilterFromJSONTyped, ArticleSearchFilterToJSON, ArticleSearchFilterToJSONTyped, type ArticleSearchParams, ArticleSearchParamsFromJSON, ArticleSearchParamsFromJSONTyped, ArticleSearchParamsToJSON, ArticleSearchParamsToJSONTyped, ArticleToJSON, ArticleToJSONTyped, type AuthException, AuthExceptionFromJSON, AuthExceptionFromJSONTyped, AuthExceptionStatusCodeEnum, AuthExceptionToJSON, AuthExceptionToJSONTyped, BASE_PATH, BaseAPI, BlobApiResponse, COLLECTION_FORMATS, type CategoryHolder, CategoryHolderFromJSON, CategoryHolderFromJSONTyped, CategoryHolderToJSON, CategoryHolderToJSONTyped, type CategoryWithScoreHolder, CategoryWithScoreHolderFromJSON, CategoryWithScoreHolderFromJSONTyped, CategoryWithScoreHolderToJSON, CategoryWithScoreHolderToJSONTyped, type Company, type CompanyCount, CompanyCountFromJSON, CompanyCountFromJSONTyped, CompanyCountToJSON, CompanyCountToJSONTyped, CompanyFromJSON, CompanyFromJSONTyped, type CompanyHolder, CompanyHolderFromJSON, CompanyHolderFromJSONTyped, CompanyHolderToJSON, CompanyHolderToJSONTyped, type CompanySearchResult, CompanySearchResultFromJSON, CompanySearchResultFromJSONTyped, CompanySearchResultToJSON, CompanySearchResultToJSONTyped, CompanyToJSON, CompanyToJSONTyped, Configuration, type ConfigurationParameters, type Consume, type Coordinate, type CoordinateFilter, CoordinateFilterFromJSON, CoordinateFilterFromJSONTyped, CoordinateFilterToJSON, CoordinateFilterToJSONTyped, CoordinateFromJSON, CoordinateFromJSONTyped, CoordinateToJSON, CoordinateToJSONTyped, DefaultConfig, type EntityHolder, EntityHolderFromJSON, EntityHolderFromJSONTyped, EntityHolderToJSON, EntityHolderToJSONTyped, type ErrorContext, type EventTypeHolder, EventTypeHolderFromJSON, EventTypeHolderFromJSONTyped, EventTypeHolderToJSON, EventTypeHolderToJSONTyped, type FetchAPI, FetchError, type FetchParams, type GetJournalistByIdRequest, type HTTPBody, type HTTPHeaders, type HTTPMethod, type HTTPQuery, type HTTPRequestInit, type IdNameHolder, IdNameHolderFromJSON, IdNameHolderFromJSONTyped, IdNameHolderToJSON, IdNameHolderToJSONTyped, type IllegalParameterException, IllegalParameterExceptionFromJSON, IllegalParameterExceptionFromJSONTyped, IllegalParameterExceptionToJSON, IllegalParameterExceptionToJSONTyped, type ImageHolder, ImageHolderFromJSON, ImageHolderFromJSONTyped, ImageHolderToJSON, ImageHolderToJSONTyped, type InitOverrideFunction, type InternalErrorException, InternalErrorExceptionFromJSON, InternalErrorExceptionFromJSONTyped, InternalErrorExceptionToJSON, InternalErrorExceptionToJSONTyped, JSONApiResponse, type Journalist, JournalistFromJSON, JournalistFromJSONTyped, type JournalistSearchResult, JournalistSearchResultFromJSON, JournalistSearchResultFromJSONTyped, JournalistSearchResultToJSON, JournalistSearchResultToJSONTyped, JournalistToJSON, JournalistToJSONTyped, type Json, type KeyPoint, KeyPointFromJSON, KeyPointFromJSONTyped, KeyPointToJSON, KeyPointToJSONTyped, type KeywordHolder, KeywordHolderFromJSON, KeywordHolderFromJSONTyped, KeywordHolderToJSON, KeywordHolderToJSONTyped, type LabelHolder, LabelHolderFromJSON, LabelHolderFromJSONTyped, LabelHolderToJSON, LabelHolderToJSONTyped, type LocationCount, LocationCountFromJSON, LocationCountFromJSONTyped, LocationCountToJSON, LocationCountToJSONTyped, type LocationHolder, LocationHolderFromJSON, LocationHolderFromJSONTyped, LocationHolderToJSON, LocationHolderToJSONTyped, type Middleware, type ModelPropertyNaming, type NameCount, NameCountFromJSON, NameCountFromJSONTyped, NameCountToJSON, NameCountToJSONTyped, type NewsCluster, NewsClusterFromJSON, NewsClusterFromJSONTyped, NewsClusterToJSON, NewsClusterToJSONTyped, type NotFoundException, NotFoundExceptionFromJSON, NotFoundExceptionFromJSONTyped, NotFoundExceptionToJSON, NotFoundExceptionToJSONTyped, type PeopleSearchResult, PeopleSearchResultFromJSON, PeopleSearchResultFromJSONTyped, PeopleSearchResultToJSON, PeopleSearchResultToJSONTyped, type Person, type PersonCount, PersonCountFromJSON, PersonCountFromJSONTyped, PersonCountToJSON, PersonCountToJSONTyped, PersonFromJSON, PersonFromJSONTyped, type PersonHolder, PersonHolderFromJSON, PersonHolderFromJSONTyped, PersonHolderToJSON, PersonHolderToJSONTyped, PersonToJSON, PersonToJSONTyped, type Place, PlaceFromJSON, PlaceFromJSONTyped, PlaceToJSON, PlaceToJSONTyped, type QuerySearchResult, QuerySearchResultFromJSON, QuerySearchResultFromJSONTyped, QuerySearchResultToJSON, QuerySearchResultToJSONTyped, type Question, QuestionFromJSON, QuestionFromJSONTyped, QuestionToJSON, QuestionToJSONTyped, type RecordStatHolder, RecordStatHolderFromJSON, RecordStatHolderFromJSONTyped, RecordStatHolderToJSON, RecordStatHolderToJSONTyped, type RequestContext, type RequestOpts, RequiredError, type ResponseContext, ResponseError, type ResponseTransformer, type ScoredArticle, ScoredArticleFromJSON, ScoredArticleFromJSONTyped, ScoredArticleToJSON, ScoredArticleToJSONTyped, type SearchArticlesRequest, type SearchCompaniesRequest, type SearchJournalistsRequest, type SearchPeopleRequest, type SearchSourcesRequest, type SearchStoriesRequest, type SearchSummarizerRequest, type SearchTopicsRequest, type SentimentHolder, SentimentHolderFromJSON, SentimentHolderFromJSONTyped, SentimentHolderToJSON, SentimentHolderToJSONTyped, SortBy, SortByFromJSON, SortByFromJSONTyped, SortByToJSON, SortByToJSONTyped, type Source, SourceFromJSON, SourceFromJSONTyped, type SourceHolder, SourceHolderFromJSON, SourceHolderFromJSONTyped, SourceHolderToJSON, SourceHolderToJSONTyped, type SourceLocation, SourceLocationFromJSON, SourceLocationFromJSONTyped, SourceLocationToJSON, SourceLocationToJSONTyped, type SourceSearchResult, SourceSearchResultFromJSON, SourceSearchResultFromJSONTyped, SourceSearchResultToJSON, SourceSearchResultToJSONTyped, SourceToJSON, SourceToJSONTyped, type SourceTopStatHolder, SourceTopStatHolderFromJSON, SourceTopStatHolderFromJSONTyped, SourceTopStatHolderToJSON, SourceTopStatHolderToJSONTyped, type StorySearchResult, StorySearchResultFromJSON, StorySearchResultFromJSONTyped, StorySearchResultToJSON, StorySearchResultToJSONTyped, type SummaryBody, SummaryBodyFromJSON, SummaryBodyFromJSONTyped, SummaryBodyMethodEnum, SummaryBodyModelEnum, SummaryBodySummarizeFieldsEnum, SummaryBodyToJSON, SummaryBodyToJSONTyped, type SummarySearchResult, SummarySearchResultFromJSON, SummarySearchResultFromJSONTyped, SummarySearchResultToJSON, SummarySearchResultToJSONTyped, type SymbolHolder, SymbolHolderFromJSON, SymbolHolderFromJSONTyped, SymbolHolderToJSON, SymbolHolderToJSONTyped, TextApiResponse, type TooManyRequestsException, type TooManyRequestsExceptionCause, TooManyRequestsExceptionCauseFromJSON, TooManyRequestsExceptionCauseFromJSONTyped, type TooManyRequestsExceptionCauseStackTraceInner, TooManyRequestsExceptionCauseStackTraceInnerFromJSON, TooManyRequestsExceptionCauseStackTraceInnerFromJSONTyped, TooManyRequestsExceptionCauseStackTraceInnerToJSON, TooManyRequestsExceptionCauseStackTraceInnerToJSONTyped, TooManyRequestsExceptionCauseToJSON, TooManyRequestsExceptionCauseToJSONTyped, TooManyRequestsExceptionFromJSON, TooManyRequestsExceptionFromJSONTyped, TooManyRequestsExceptionStatusEnum, type TooManyRequestsExceptionSuppressedInner, TooManyRequestsExceptionSuppressedInnerFromJSON, TooManyRequestsExceptionSuppressedInnerFromJSONTyped, TooManyRequestsExceptionSuppressedInnerToJSON, TooManyRequestsExceptionSuppressedInnerToJSONTyped, TooManyRequestsExceptionToJSON, TooManyRequestsExceptionToJSONTyped, type TopicDto, TopicDtoFromJSON, TopicDtoFromJSONTyped, TopicDtoToJSON, TopicDtoToJSONTyped, type TopicHolder, TopicHolderFromJSON, TopicHolderFromJSONTyped, TopicHolderToJSON, TopicHolderToJSONTyped, type TopicLabels, TopicLabelsFromJSON, TopicLabelsFromJSONTyped, TopicLabelsToJSON, TopicLabelsToJSONTyped, type TopicSearchResult, TopicSearchResultFromJSON, TopicSearchResultFromJSONTyped, TopicSearchResultToJSON, TopicSearchResultToJSONTyped, V1Api, type V1ApiInterface, type VectorSearchArticlesRequest, type VectorSearchResult, VectorSearchResultFromJSON, VectorSearchResultFromJSONTyped, VectorSearchResultToJSON, VectorSearchResultToJSONTyped, VoidApiResponse, type WebResources, WebResourcesFromJSON, WebResourcesFromJSONTyped, WebResourcesToJSON, WebResourcesToJSONTyped, type WikidataDateHolder, WikidataDateHolderFromJSON, WikidataDateHolderFromJSONTyped, WikidataDateHolderToJSON, WikidataDateHolderToJSONTyped, type WikidataLabelHolder, WikidataLabelHolderFromJSON, WikidataLabelHolderFromJSONTyped, WikidataLabelHolderToJSON, WikidataLabelHolderToJSONTyped, type WikidataPoliticalPartyHolder, WikidataPoliticalPartyHolderFromJSON, WikidataPoliticalPartyHolderFromJSONTyped, WikidataPoliticalPartyHolderToJSON, WikidataPoliticalPartyHolderToJSONTyped, type WikidataPositionHolder, WikidataPositionHolderFromJSON, WikidataPositionHolderFromJSONTyped, WikidataPositionHolderToJSON, WikidataPositionHolderToJSONTyped, canConsumeForm, exists, instanceOfAllEndpointSortBy, instanceOfArticle, instanceOfArticleSearchFilter, instanceOfArticleSearchParams, instanceOfAuthException, instanceOfCategoryHolder, instanceOfCategoryWithScoreHolder, instanceOfCompany, instanceOfCompanyCount, instanceOfCompanyHolder, instanceOfCompanySearchResult, instanceOfCoordinate, instanceOfCoordinateFilter, instanceOfEntityHolder, instanceOfEventTypeHolder, instanceOfIdNameHolder, instanceOfIllegalParameterException, instanceOfImageHolder, instanceOfInternalErrorException, instanceOfJournalist, instanceOfJournalistSearchResult, instanceOfKeyPoint, instanceOfKeywordHolder, instanceOfLabelHolder, instanceOfLocationCount, instanceOfLocationHolder, instanceOfNameCount, instanceOfNewsCluster, instanceOfNotFoundException, instanceOfPeopleSearchResult, instanceOfPerson, instanceOfPersonCount, instanceOfPersonHolder, instanceOfPlace, instanceOfQuerySearchResult, instanceOfQuestion, instanceOfRecordStatHolder, instanceOfScoredArticle, instanceOfSentimentHolder, instanceOfSortBy, instanceOfSource, instanceOfSourceHolder, instanceOfSourceLocation, instanceOfSourceSearchResult, instanceOfSourceTopStatHolder, instanceOfStorySearchResult, instanceOfSummaryBody, instanceOfSummarySearchResult, instanceOfSymbolHolder, instanceOfTooManyRequestsException, instanceOfTooManyRequestsExceptionCause, instanceOfTooManyRequestsExceptionCauseStackTraceInner, instanceOfTooManyRequestsExceptionSuppressedInner, instanceOfTopicDto, instanceOfTopicHolder, instanceOfTopicLabels, instanceOfTopicSearchResult, instanceOfVectorSearchResult, instanceOfWebResources, instanceOfWikidataDateHolder, instanceOfWikidataLabelHolder, instanceOfWikidataPoliticalPartyHolder, instanceOfWikidataPositionHolder, mapValues, querystring };