Search Summarizer
Produce a single, concise summary over the full corpus of articles matching your filters, using your prompt to guide which insights to highlight.
Query parameters
String. 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.
String. Search specifically within article headlines/titles. Supports Boolean operators, exact phrases with quotes, and wildcards for matching title variations.
String. Search within article description fields. Supports Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching.
String. Search within the full article body content. Supports Boolean logic, exact phrase matching with quotes, and wildcards for comprehensive content searching.
String. Search within article summary fields. Supports Boolean expressions, exact phrase matching with quotes, and wildcards for flexible pattern matching.
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=cnn.com&url=travel.
String Array. Retrieve specific news articles by their unique article identifiers. Multiple IDs can be provided to return a collection of specific articles.
String Array. 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.
String. 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).
Integer. The specific page of results to retrieve in the paginated response. Starts at 0.
Integer. The number of articles to return per page in the paginated response.
Date. Filter for articles published after this date. Accepts ISO 8601 format (e.g., 2023-03-01T00:00:00) or yyyy-mm-dd format.
Date. Filter for articles published before this date. Accepts ISO 8601 format (e.g., 2022-02-01T23:59:59) or yyyy-mm-dd format.
Date. 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.
Date. 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.
Date. 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.
Date. 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.
String Array. Filter articles by their primary medium type. Accepts Article for written content or Video for video-based stories. Multiple values create an OR filter.
String Array. Filter articles by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com). Multiple values create an OR filter.
String Array. 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.
String Array. 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).
String Array. 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.
String Array. Filter articles using watchlists of people and companies. Multiple values create an OR filter to include articles mentioning any entity from the specified watchlists.
String Array. Exclude articles mentioning entities from specified watchlists. Multiple values create an AND-exclude filter, removing content mentioning any entity from the specified watchlists.
Boolean. Filter to show only results where the source has a paywall (true) or does not have a paywall (false).
String Array. 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.
String Array. 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.
String Array. 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.
String Array. Filter by unique journalist identifiers which can be found through the Journalist API or in the matchedAuthors field. Multiple values create an OR filter.
String Array. Exclude articles written by specific journalists identified by their unique IDs. Multiple values create an AND-exclude filter.
String Array. Filter articles by their language using ISO-639 two-letter codes (e.g., en, es, fr). Multiple values create an OR filter.
String Array. Exclude articles in specific languages using ISO-639 two-letter codes. Multiple values create an AND-exclude filter.
Boolean. Expand search to include translated content fields for non-English articles. When true, searches translated title, description, and content fields.
String Array. Filter articles by editorial labels such as Opinion, Paid-news, Non-news, Fact Check, or Press Release. Multiple values create an OR filter.
String Array. Exclude articles with specific editorial labels. Multiple values create an AND-exclude filter, removing all content with any of these labels.
String Array. 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.
String Array. Exclude articles with specific categories. Multiple values create an AND-exclude filter, removing all content with any of these categories.
String Array. 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.
String Array. Exclude articles with specific topics. Multiple values create an AND-exclude filter, removing all content with any of these topics.
String. Returns only articles that contain links to the specified URL pattern. Matches against the 'links' field in article responses.
Boolean. 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.
String. 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.
String Array. 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.
String Array. A list of cities to exclude from the results. Articles that are associated with any of the specified cities will be filtered out.
String Array. 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.
String Array. 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.
String Array. 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).
String Array. 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.
String Array. 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
String Array. 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.
String Array. Country code to filter by country. If multiple parameters are passed, they will be applied as OR operations.
String Array. 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.
String Array. 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'.
Float. Latitude of the center point to search places
Float. Longitude of the center point to search places
Float. Maximum distance (in km) from starting point to search articles by tagged places
String Array. Find articles published by sources that are located within a given city.
String Array. Excludes articles published by sources that are located within the specified cities.
String Array. Find articles published by sources that are located within a given county.
String Array. Excludes articles published by sources that are located within the specified counties.
String Array. Find articles published by sources that are located within a given country. Must be 2 character country code (i.e. us, gb, etc).
String Array. Excludes articles published by sources that are located within the specified countries. Must be 2 character country codes (e.g., us, gb).
String Array. Find articles published by sources that are located within a given state.
String Array. Excludes articles published by sources that are located within the specified states.
Float. Latitude of the center point to search articles created by local publications.
Float. Latitude of the center point to search articles created by local publications.
Float. Maximum distance from starting point to search articles created by local publications.
String Array. Filter articles by Wikidata IDs of mentioned people. Refer to the /people endpoint for a complete list of tracked individuals.
String Array. 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.
String Array. Filter articles by exact person name matches. Does not support Boolean or complex logic. For available person entities, consult the /people endpoint.
String Array. Exclude articles mentioning specific people by name. Creates an AND-exclude filter to remove content about these individuals.
String Array. Filter articles by company identifiers. For a complete list of tracked companies, refer to the /companies endpoint.
String Array. Exclude articles mentioning companies with specific identifiers. Creates an AND-exclude filter to remove content about these corporate entities.
String. Filter articles by company name mentions. Performs an exact match on company names.
String Array. Filter articles by company domains (e.g., apple.com). For available company entities, consult the /companies endpoint.
String Array. Exclude articles related to companies with specific domains. Creates an AND-exclude filter to remove content about these companies.
String Array. Filter articles by company stock symbols. For available company entities and their symbols, consult the /companies endpoint.
String Array. 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.
Boolean. 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.
Float. 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.
Float. 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.
Float. 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.
Float. 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.
Float. 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.
Float. 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.
String Array. 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
String. Filters by Google Content Categories. This field will filter by the category prefix only. Example: prefixTaxonomy=/Finance
Boolean. When set to true, enables text highlighting in search results.
Integer. Specifies the size in characters of each highlighted text fragment. Defaults to 100 if not specified.
Integer. Controls the maximum number of highlighted fragments to return per field.
String. Defines the HTML tag that appears before highlighted text. Defaults to '<em>' if not specified.
String. Defines the HTML tag that appears after highlighted text. Defaults to '</em>' if not specified.
String. 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.
Request body
Response
200 - Success
Example response
{
"status": 200,
"numResults": 10,
"summary": "Across these articles, a few themes stand out: public concern and adaptation in the face of ongoing challenges, whether in pandemic management, economic shifts, or even sports. In the U.S., anxiety about COVID-19 is surging again as the delta variant spreads, with Americans divided yet increasingly supportive of mask and vaccine mandates, even as federal travel restrictions persist at the borders. Meanwhile, regions like Rheinland-Pfalz in Germany are experiencing rising infection rates, signaling the fourth wave’s intensification. On the economic front, both the industrial fastening equipment and intravascular ultrasound catheter markets are navigating recovery, competition, and supply chain intricacies, highlighting the pandemic’s ripple effects. Elsewhere, local politics—like Lipetsk’s focus on wages and infrastructure, or Russia’s restoration of energy market competition—reflect everyday priorities. Even in sports, player transfers and injuries illustrate how life’s routines continue, albeit under new pressures and uncertainties.",
"results": [
{
"url": "https://www.recorderonline.com/news/national_news/covid-anxiety-rising-amid-delta-surge-ap-norc-poll-finds/article_0f59e7ab-864d-5690-b6f5-692cd9903d40.html",
"authorsByline": "JAMES ANDERSON and HANNAH FINGERHUT Associated Press",
"articleId": "cbf66b7f0ec641528180766d7a1f95d6",
"clusterId": "6c262dee867f45588b43da0066126f79",
"source": {
"domain": "recorderonline.com",
"location": null
},
"imageUrl": "https://bloximages.newyork1.vip.townnews.com/recorderonline.com/content/tncms/assets/v3/editorial/2/44/244be964-8860-5c56-bc92-95b2cf717acf/611fab31295f3.image.jpg?resize=945%2C630",
"country": "us",
"language": "en",
"pubDate": "2021-08-20T13:12:55+00:00",
"addDate": "2021-08-22T01:07:16.414408+00:00",
"refreshDate": "2021-08-22T01:07:16.414408+00:00",
"score": 1,
"title": "COVID anxiety rising amid delta surge, AP-NORC poll finds",
"description": "COVID anxiety rising amid delta surge, AP-NORC poll finds Porterville Recorder",
"content": "DENVER (AP) — Anxiety in the United States over COVID-19 is at its highest level since winter, a new poll shows, as the delta variant rages, more states and school districts adopt mask and vaccination requirements and the nation’s hospitals once again fill to capacity.\n\nThe poll from The Associated Press-NORC Center for Public Affairs Research also finds that majorities of American adults want vaccination mandates for those attending movies, sports, concerts and other crowded events; those traveling by airplane; and workers in hospitals, restaurants, stores and government offices.\n\nThe poll shows that 41% are “extremely” or “very” worried about themselves or their family becoming infected with the virus. That is up from 21% in June, and about the same as in January, during the country's last major surge, when 43% were extremely or very worried.\n\n“I wouldn’t have said this a couple of years ago, but I’m not as confident as I was in America’s ability to take care of itself,” said David Bowers, a 42-year-old business analyst in the Phoenix suburb of Peoria.\n\nBowers, a Democrat, and his wife, a public school teacher, got vaccinated early. But they fret once again about their daughters, ages 7 and 9, attending school in a state whose Republican governor, Doug Ducey, signed a law to block school districts from mandating masks, let alone vaccines.\n\nA brief summer respite from COVID-19 fatigue included a family trip to New York. “COVID was pretty much out of mind,\" Bowers said. \"Now it feels like we’re going backward.”\n\nClose to 6 in 10 Americans say they favor requiring people to be fully vaccinated against COVID-19 to travel on an airplane or attend crowded public events. Only about a quarter of Americans oppose such measures.\n\nRoughly 6 in 10 also support vaccine mandates for hospital or other health care workers, along with government employees, members of the military and workers who interact with the public, such as in restaurants and stores. Support is slightly lower for requiring vaccinations to go out to a bar or restaurant, though more are in favor than opposed, 51% to 28%.\n\nNearly 200 million people, or just over 60% of the U.S. population, had received at least one vaccine dose as of Thursday, according to the Centers for Disease Control and Prevention. Just over half of the population was fully vaccinated.\n\nHospitals across the U.S. had more than 75,000 coronavirus patients as of last week, a dramatic increase from a few weeks ago but still well below the winter surge records. Florida, Arkansas, Oregon, Hawaii, Louisiana and Mississippi have set records for COVID-19 hospitalizations in recent weeks, and the surge in the delta variant, combined with low vaccination rates, has produced a scramble to find beds for patients.\n\nThe poll suggests that despite increasing cases and greater concern about the virus, Americans have not stepped up their own precautionary behavior since June, though at least half still say they always or often wear a mask around other people, stay away from large groups and avoid nonessential travel.\n\nConfidence in vaccines to withstand virus variants has not waned, either, as U.S. health officials this week announced plans to dispense booster shots to all Americans to shore up their protection. The doses could begin next month.\n\nCarla Jones, 37, of Lafayette, Louisiana, is a paraplegic with immunity problems and uses a wheelchair after she was severely injured in a car accident. Because of her health, she has been told by her doctor she cannot get the vaccine. She gets anxious visiting the doctor or when her grandchildren visit.\n\n“I see someone next to me at the doctor’s without a mask, it makes my heart rapidly beat faster,” Jones said.\n\nJones, a Democrat, strongly favors vaccination and mask mandates, and not just for herself. “For the good of all,” she said. \"I don’t have the shot, but I definitely wouldn’t want to pass it on to anyone else.”\n\nThe poll shows that 55% support requiring Americans to wear masks around other people outside their homes, while 62% support mask mandates specifically for workers who interact with the public, such as at restaurants and stores. Eighty-five percent of Democrats and 39% of Republicans are in favor of mask mandates for public-facing workers.\n\nRobbie Allen, a 63-year-old retiree from Clifton, Texas, is fully vaccinated and will wear a mask when required by stores or other places. But the self-described independent who leans Republican insists it is a matter of personal choice, and he sees mandates as taking the joy out of life.\n\n“The COVID is not going away very quickly, but I don’t think people should live in fear,\" said Allen, who motorcycled with his girlfriend to this month's Sturgis Motorcycle Rally, which attracted hundreds of thousands to the South Dakota city. “People are going to die, but if we all hunker down, life gets miserable.\"\n\nPartisan gaps are also wide on vaccination requirements. In Arizona, Bowers has already taken time off work to pick up his daughter from school after she developed a high fever. They spent hours last week looking for a drive-thru COVID-19 testing site that wasn’t overcrowded. She tested negative. But the worries persist.\n\n“My thinking is, the people who don’t want mandates are the people who need to be regulated,” Bowers said. \"There’s a slim majority in this country making the right decisions. If it wasn’t for a slim majority as a country, we’d be in trouble.”\n\nThe AP-NORC poll of 1,729 adults was conducted Aug. 12-16 using a sample drawn from NORC’s probability-based AmeriSpeak Panel, which is designed to be representative of the U.S. population. The margin of sampling error for all respondents is plus or minus 3.2 percentage points.",
"medium": "Article",
"labels": [
{
"name": "Opinion"
}
],
"matchedAuthors": [],
"claim": "",
"verdict": "",
"keywords": [
{
"name": "mask mandates",
"weight": 0.07696303
},
{
"name": "vaccine mandates",
"weight": 0.06830935
},
{
"name": "vaccination mandates",
"weight": 0.06619582
},
{
"name": "other people",
"weight": 0.06527583
},
{
"name": "masks",
"weight": 0.06391404
},
{
"name": "other crowded events",
"weight": 0.06374716
},
{
"name": "last week",
"weight": 0.062233474
},
{
"name": "recent weeks",
"weight": 0.059354812
},
{
"name": "virus variants",
"weight": 0.059015423
},
{
"name": "school districts",
"weight": 0.058817048
}
],
"topics": [
{
"name": "Coronavirus"
},
{
"name": "Polls"
}
],
"categories": [],
"taxonomies": [],
"entities": [
{
"data": "hours",
"type": "TIME",
"mentions": 1
},
{
"data": "David Bowers",
"type": "PERSON",
"mentions": 5
},
{
"data": "Jones",
"type": "PERSON",
"mentions": 2
},
{
"data": "Doug Ducey",
"type": "PERSON",
"mentions": 1
},
{
"data": "Carla Jones",
"type": "PERSON",
"mentions": 1
},
{
"data": "Robbie Allen",
"type": "PERSON",
"mentions": 1
},
{
"data": "Allen",
"type": "PERSON",
"mentions": 1
},
{
"data": "AP",
"type": "ORG",
"mentions": 2
},
{
"data": "The Associated Press-NORC Center for Public Affairs Research",
"type": "ORG",
"mentions": 1
},
{
"data": "the Centers for Disease Control and Prevention",
"type": "ORG",
"mentions": 1
},
{
"data": "COVID",
"type": "ORG",
"mentions": 1
},
{
"data": "NORC",
"type": "ORG",
"mentions": 1
},
{
"data": "the United States",
"type": "GPE",
"mentions": 6
},
{
"data": "Louisiana",
"type": "GPE",
"mentions": 2
},
{
"data": "DENVER",
"type": "GPE",
"mentions": 1
},
{
"data": "Phoenix",
"type": "GPE",
"mentions": 1
},
{
"data": "Peoria",
"type": "GPE",
"mentions": 1
},
{
"data": "New York",
"type": "GPE",
"mentions": 1
},
{
"data": "Florida",
"type": "GPE",
"mentions": 1
},
{
"data": "Arkansas",
"type": "GPE",
"mentions": 1
},
{
"data": "Oregon",
"type": "GPE",
"mentions": 1
},
{
"data": "Hawaii",
"type": "GPE",
"mentions": 1
},
{
"data": "Mississippi",
"type": "GPE",
"mentions": 1
},
{
"data": "Lafayette",
"type": "GPE",
"mentions": 1
},
{
"data": "Clifton",
"type": "GPE",
"mentions": 1
},
{
"data": "Texas",
"type": "GPE",
"mentions": 1
},
{
"data": "South Dakota",
"type": "GPE",
"mentions": 1
},
{
"data": "Arizona",
"type": "GPE",
"mentions": 1
},
{
"data": "delta",
"type": "LOC",
"mentions": 1
},
{
"data": "COVID",
"type": "EVENT",
"mentions": 1
},
{
"data": "Sturgis Motorcycle Rally",
"type": "EVENT",
"mentions": 1
},
{
"data": "American",
"type": "NORP",
"mentions": 6
},
{
"data": "Democrat",
"type": "NORP",
"mentions": 3
},
{
"data": "Republican",
"type": "NORP",
"mentions": 3
}
],
"sentiment": {
"positive": 0.05536453,
"negative": 0.6762484,
"neutral": 0.26838717
},
"summary": "\n\nThe poll from The Associated Press-NORC Center for Public Affairs Research also finds that majorities of American adults want vaccination mandates for those attending movies, sports, concerts and other crowded events; those traveling by airplane; and workers in hospitals, restaurants, stores and government offices. But they fret once again about their daughters, ages 7 and 9, attending school in a state whose Republican governor, Doug Ducey, signed a law to block school districts from mandating masks, let alone vaccines. \n\nJones, a Democrat, strongly favors vaccination and mask mandates, and not just for herself. “For the good of all,” she said. \"I don’t have the shot, but I definitely wouldn’t want to pass it on to anyone else.”\n\nThe poll shows that 55% support requiring Americans to wear masks around other people outside their homes, while 62% support mask mandates specifically for workers who interact with the public, such as at restaurants and stores.",
"translation": "",
"locations": [],
"reprint": true,
"places": null
}
]
}