ASasknews
reddit

Search Reddit, summarize threads, and return analysis.

Go to Reddit, search threads, summarize the threads, return analysis. deep=True is a live web scrape, AskNews searches Reddit, finds threads, summarizes them, analyzes them, and returns the results. deep=False is a search in AskNews' existing database of Reddit threads.

get/v1/reddit/search

Request

Query parameters

keywordsstring[] required

Keywords used to search for relevant Reddit threads.

n_threadsinteger

Number of Reddit threads to summarize and return

method'nl' | 'kw'

The search method. Can be 'nl' or 'kw'. If 'nl', then the query will be used as a natural language query. If 'kw', then the query will be used as a direct keyword query.

deepboolean

Deep means that AskNews goes directly to Reddit, searches live, summarizes the threads live, and returns structured data for you. Deep=False means that AskNews looks in its existing database of Reddit threads and returns the most similar threads

return_type'dicts' | 'string' | 'both'

The return type. Can be 'dicts', 'string', or 'both'.

time_filter'hour' | 'day' | 'week' | 'month' | 'year' | 'all'

The time filter.

sort'relevance' | 'hot' | 'top' | 'new' | 'comments'

The sort order.

Response

The summarized Reddit threads.

as_stringstring nullable

Changes

No recorded changes to this operation across all 11 revisions of this API.