Filter and search for top news narratives
Filter on our custom, in-house written, stories/events/narratives.
These stories are based on clusters of articles (which come through this endpoint as well, so you can consider this a clustering endpoint). We write stories and track them through time.
The enrichments include a full Reddit overview (including all the thread metadata), as well as descriptions of the reporting voice, the key takeaways, contradictions, all the entities, and much, much more.
You can see this data in action, and filter it similarly at https://asknews.app/stories
Query parameters
Query to be used for the search. If method='nl', then this will beused as a natural language query. If method='kw', then this willbe used as a direct keyword query.
Query to be used for the search. If method='nl', then this will beused as a natural language query. If method='kw', then this willbe used as a direct keyword query.
Categories to use for filtering the stories search
Categories to use for filtering the stories search
A list of UUIDs to retrieve.
A list of UUIDs to retrieve.
Start timestamp to filter results on.
Start timestamp to filter results on.
End timestamp to filter results on.
End timestamp to filter results on.
Which type of sorting to perform. published: Sort by published date. coverage: Sort by coverage. sentiment: Sort by sentiment. relevance: Sort by relevance of similarity score/ranking.
Which type of sorting to perform. published: Sort by published date. coverage: Sort by coverage. sentiment: Sort by sentiment. relevance: Sort by relevance of similarity score/ranking.
Whether to sort results in ascending or descending order.
Whether to sort results in ascending or descending order.
Continents to filter by.
Offset to use
Limit to use
Limit to use
Whether to expand updates
Whether to expand updates
Max updates to use
Max updates to use
Max articles to use per update
Max articles to use per update
Method to use for query, 'nl' means natural language, and will run a semantic search on the stories database. 'kw' means keyword, and will search by keyword on the stories database. 'both' means that both methods will be used and results will be ranked according to IRR.
Method to use for query, 'nl' means natural language, and will run a semantic search on the stories database. 'kw' means keyword, and will search by keyword on the stories database. 'both' means that both methods will be used and results will be ranked according to IRR.
Object type to filter by, can be a list with 'story' and/or 'story_update'
Object type to filter by, can be a list with 'story' and/or 'story_update'
Whether or not to include Reddit analysiswhere the integer indicates the number of threadsto include in the response. 0 is default. Requirespaid plan to access.
Whether or not to include Reddit analysiswhere the integer indicates the number of threadsto include in the response. 0 is default. Requirespaid plan to access.
Method to use for citation filtering.
Method to use for citation filtering.
Similarity score threshold to use when using query
Similarity score threshold to use when using query
Filter stories based on how provocative the underlying articles are deemed based on the use of provocative language and emotional vocabulary.
Filter stories based on how provocative the underlying articles are deemed based on the use of provocative language and emotional vocabulary.
Strategy to use for automatically controlling the search. 'default' is the default strategy, which follows all filters faithfully. 'topstories' aims to give a diverse look at top news stories that are relevant to the current filter combination.'topstories_categories' aims to give the top stories for each category. 'topstories_continents' aims to give the top stories for each continent.
Strategy to use for automatically controlling the search. 'default' is the default strategy, which follows all filters faithfully. 'topstories' aims to give a diverse look at top news stories that are relevant to the current filter combination.'topstories_categories' aims to give the top stories for each category. 'topstories_continents' aims to give the top stories for each continent.
Response
A list of stories with updates
Changes
No recorded changes to this endpoint across all 1 revision of this API.