PerigonInstall

Summary

Search stories by specifying a query and optional filters like category, country, date range, source domains, and topics, while controlling pagination, sorting, and display options.

Inputs

• Query (required) — Text query to filter stories based on their name, summary, and key points.
• Additional Options — Optional filters including category, country codes, date range (from, to), minimum cluster size and unique sources, pagination (page, size), sorting criteria, source domains, topics, and whether to show the total number of matching stories.

Output shape

a list of story objects matching the search criteria

Results are paginated according to the 'page' and 'size' parameters. Each story object includes clustering information and metadata. If 'showNumResults' is true, the total count of matched stories is included.