Search Summarizer

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.

Search specifically within article headlines/titles. Supports Boolean operators, exact phrases with quotes, and wildcards for matching title variations.

Search within article description fields. Supports Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching.

Search within the full article body content. Supports Boolean logic, exact phrase matching with quotes, and wildcards for comprehensive content searching.

Search within article URLs to find content from specific website sections or domains. Supports wildcards (* and ?) for partial URL matching.

Retrieve specific news articles by their unique article identifiers. Multiple IDs can be provided to return a collection of specific articles.

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.

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).

The specific page of results to retrieve in the paginated response. Starts at 0.

The number of articles to return per page in the paginated response.

Filter for articles published after this date. Accepts ISO 8601 format (e.g., 2023-03-01T00:00:00) or yyyy-mm-dd format.

Filter for articles published before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.

Filter for articles added to Perigon's system after this date. Accepts ISO 8601 format (e.g., 2022-02-01T00:00:00) or yyyy-mm-dd format.

Filter for articles added to Perigon's system before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.

Filter for articles refreshed/updated in Perigon'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.

Filter for articles refreshed/updated in Perigon'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.

Filter articles by their primary medium type. Accepts Article for written content or Video for video-based stories. Multiple values create an OR filter.

Filter articles by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an OR filter.

Filter articles using Perigon's curated publisher bundles (e.g., top100, top25crypto). Multiple values create an OR filter to include articles from any of the specified bundles.

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).

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.

Filter to show only results where the source has a paywall (true) or does not have a paywall (false).

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.

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.

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.

Filter by unique journalist identifiers which can be found through the Journalist API or in the matchedAuthors field. Multiple values create an OR filter.

Exclude articles written by specific journalists identified by their unique IDs. Multiple values create an AND-exclude filter.

Filter articles by their language using ISO-639 two-letter codes (e.g., en, es, fr). Multiple values create an OR filter.

Exclude articles in specific languages using ISO-639 two-letter codes. Multiple values create an AND-exclude filter.

Expand search to include translated content fields for non-English articles. When true, searches translated title, description, and content fields.

Filter articles by editorial labels such as Opinion, Paid-news, Non-news, Fact Check, or Press Release. Multiple values create an OR filter.

Exclude articles with specific editorial labels. Multiple values create an AND-exclude filter, removing all content with any of these labels.

Filter by broad content categories such as Politics, Tech, Sports, Business, or Finance. Use 'none' to find uncategorized articles. Multiple values create an OR filter.

Exclude articles with specific categories. Multiple values create an AND-exclude filter, removing all content with any of these categories.

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.

Exclude articles with specific topics. Multiple values create an AND-exclude filter, removing all content with any of these topics.

Returns only articles that contain links to the specified URL pattern. Matches against the 'links' field in article responses.

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.

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.

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.

A list of cities to exclude from the results. Articles that are associated with any of the specified cities will be filtered out.

Filters articles where a specified area, such as a neighborhood, borough, or district, plays a central role in the content, beyond mere mentions, to ensure the results are deeply relevant to the area in question. If multiple parameters are passed, they will be applied as OR operations.

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.

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).

A list of counties to include (or specify) in the search results. This field filters the returned articles based on the county associated with the event or news. Only articles tagged with one of these counties will be included.

Excludes articles from specific counties or administrative divisions in the 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

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.

Country code to filter by country. If multiple parameters are passed, they will be applied as OR operations.

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.

Return all articles that have the specified location. Location attributes are delimited by ':' between key and value, and '::' between attributes. Example: 'city:New York::state:NY'.

Latitude of the center point to search places

Longitude of the center point to search places

Maximum distance (in km) from starting point to search articles by tagged places

Find articles published by sources that are located within a given city.

Find articles published by sources that are located within a given county.

Find articles published by sources that are located within a given country. Must be 2 character country code (i.e. us, gb, etc).

Find articles published by sources that are located within a given state.

Latitude of the center point to search articles created by local publications.

Latitude of the center point to search articles created by local publications.

Maximum distance from starting point to search articles created by local publications.

Filter articles by Wikidata IDs of mentioned people. Refer to the /people endpoint for a complete list of tracked individuals.

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.

Filter articles by exact person name matches. Does not support Boolean or complex logic. For available person entities, consult the /people endpoint.

Exclude articles mentioning specific people by name. Creates an AND-exclude filter to remove content about these individuals.

Filter articles by company identifiers. For a complete list of tracked companies, refer to the /companies endpoint.

Exclude articles mentioning companies with specific identifiers. Creates an AND-exclude filter to remove content about these corporate entities.

Filter articles by company name mentions. Performs an exact match on company names.

Filter articles by company domains (e.g., apple.com). For available company entities, consult the /companies endpoint.

Exclude articles related to companies with specific domains. Creates an AND-exclude filter to remove content about these companies.

Filter articles by company stock symbols. For available company entities and their symbols, consult the /companies endpoint.

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.

Whether to show the total number of all matched articles. Default value is false which makes queries a bit more efficient but also counts up to 10000 articles.

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.

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.

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.

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.

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.

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.

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. Full list

Filters by Google Content Categories. This field will filter by the category prefix only. Example: prefixTaxonomy=/Finance

When set to true, enables text highlighting in search results.

Specifies the size in characters of each highlighted text fragment. Defaults to 100 if not specified.

Controls the maximum number of highlighted fragments to return per field.

Defines the HTML tag that appears before highlighted text. Defaults to '<em>' if not specified.

Defines the HTML tag that appears after highlighted text. Defaults to '</em>' if not specified.

Specifies a separate query for highlighting, allowing highlights based on terms different from the main search query. Example: main query 'q=climate change' with 'highlightQ=renewable OR solar' will highlight terms 'renewable' and 'solar' in results about climate change.