Omni Search

Returns threads from across Reddit for one keyword with their top comments inline at top_comments, plus a roll-up of which subreddits are talking, their weekly active users and tone.

Use it for a customer-listening sweep in one call rather than running search then post/comments per thread; it is slow and relevance is loose.

Metered: 50–90 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by cursor: see Pagination.

get/v1/reddit/omni-search

Request

Base URL: https://api.insightsocial.app
URL: https://api.insightsocial.app/v1/reddit/omni-search
Auth: API key in header x-api-key

Query parameters

querystring required

Example:best mechanical keyboard

Keyword or phrase to sweep across Reddit.

threadsinteger

Example:5

How many top threads to expand comments for (1-8, default 8).

sort'relevance' | 'new' | 'top' | 'comment_count'

Search sort order (relevance | new | top | comment_count).

timeframe'all' | 'day' | 'week' | 'month' | 'year'

Time window for the search (all | day | week | month | year).

subredditstring

Scope the sweep to one subreddit (bare name, no r/ prefix).

cursorstring

Opaque cursor from a prior response's next_cursor to page deeper.

includestring

CSV subset of subreddits,comments (default both). The comments block is returned as threads[].top_comments.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required

platformstring required

endpointstring required

schema_version'2' required

dataConventionsData required

unavailablestring[] required

credits_usedinteger required

credits_remaininginteger required

request_idstring required

cachedboolean required

idempotent_replayboolean required

charge_reasonstring required

free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.