Insight Social
GET /v1/reddit/search/comments

Reddit Search Comments API

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.

10 credits a call · cursor pagination · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/reddit/search/comments?query=best+project+management+software" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "reddit",
"endpoint": "/v1/reddit/search/comments",
"schema_version": "2",
"data": {
"items": [
{
"comment": {
"id": "<string>",
"url": "<string | null>",
"parent_id": "<string | null>",
"post_id": "<string | null>",
"text": "<string | null>",
"author": {
"id": "<string | null>",
"username": "<string | null>",
"display_name": "<string | null>",
"avatar_url": "<string | null>",
"verified": "<boolean | null>"
},
"engagement": {
"likes": "<integer | null>",
"replies": "<integer | null>"
},
"flags": {
"pinned": "<boolean | null>",
"deleted": "<boolean>"
},
"published_at": "<string | null>",
"language": "<string | null>",
"replies": "<array | null>",
"ext": "<object | null>"
}
}
]
},
"pagination": {
"next_cursor": "<string | null>",
"has_more": "<boolean>"
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

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: the platform does not report thread position.

Parameters

Query parameters for GET /v1/reddit/search/comments. Send your key in the x-api-key header.

NameRequiredDescription
queryYesSearch 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.
sortNoSort order for the comment hits.
cursorNoCursor to get more results. Get 'cursor' from the previous response.

Response fields

The same unified schema every platform returns, so code written for Reddit works on the other eight. A field the platform did not provide is null and listed in unavailable.

FieldTypeNotes
idstringAn identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
urlstring | null
parent_idstring | nullAn identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
post_idstring | nullAn identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
textstring | null
author.idstring | null
author.usernamestring | null
author.display_namestring | null
author.avatar_urlstring | null
author.verifiedboolean | null
engagement.likesinteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
engagement.repliesinteger | nullA count. null when the platform does not expose it; 0 only when it is really zero.
flags.pinnedboolean | null
flags.deletedboolean
published_atstring | nullISO-8601 timestamp in UTC, ending in Z.
languagestring | nullThe content's language as the platform states it, e.g. en, pt-BR. Detected languages come later (§7.1).
repliesarray | null
extobject | nullPlatform-specific fields, snake_case.

Every field, error and example is in the Reddit Search Comments API reference.

How much does the Reddit Search Comments API cost?

10 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Reddit Search Comments API: frequently asked questions

Send GET /v1/reddit/search/comments with the query parameter and your key in the x-api-key header. 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.