reddit

Search › Comments

Returns comments matching a phrase from Reddit's comment index, each with its parent post inline: ext.post_title, ext.subreddit, ext.post_score and ext.post_url.

Use it when the phrase lives in a reply rather than a title, and for author:username or subreddit:name sweeps. parent_id is null: search results do not report thread position.

10 credits per call.

Paginates by cursor: see Pagination.

get/v1/reddit/search/comments

Request

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

Query parameters

querystring required
Example:best project management software

Search phrase. Reddit's operators work here: author:username for one account's comments, subreddit:name terms to scope to a community, and quotes for an exact phrase.

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

Sort order for the comment hits.

cursorstring

Cursor to get more results. Get 'cursor' from the previous response.

sincestring

Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off the page, and the page that reaches one ends the walk: next_cursor is not returned and pagination.stopped_at is since. Sending it sets the newest-first sort shown in this endpoint's sort parameter (any other sort value is a free 400). The page still costs what a page costs, so you pay for the pages you walk and no more. A row with no date is kept.

untilstring

Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept.

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
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.