Post comments

A post's comments in thread order, each with its depth. With comment_id, that comment's thread.

GET/v1/reddit/posts/comments1 credit

Headers

Get your API key

x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

post_idstringoptionalquery

A post's id: the part after /comments/ in its link, with or without t3_. Give post_id or url.

example: 1wkziub

urlstringoptionalquery

A post's link: reddit.com/r/<name>/comments/<id>/, with anything after it, or redd.it/<id>. Give post_id or url.

max 300 chars

sortenumoptionalquery

The order: best, top, new, controversial, old, or qa (Reddit's Q&A order).

one of: best, top, new, controversial, old, qa · default: best

comment_idstringoptionalquery

A comment's id, with or without t1_: that comment's thread instead of the post's top comments. Use it to get the replies a comment's more_replies counts.

cursorstringoptionalquery

For the next page: page.next_cursor from the page before. Send the other parameters again with it.

Response fields

dataarray

The result: one object, or a list for the endpoints that return several.

data[].idstring

The comment's id, with Reddit's t1_ prefix.

data[].urlstringnullable

The comment's link.

data[].post_idstringnullable

The id of the post it is on, with Reddit's t3_ prefix.

data[].parent_idstringnullable

The id of the comment it replies to; null for a top-level comment.

data[].depthintegernullable

How deep in the thread it is: 0 for a top-level comment, 1 for a reply to one, and so on.

data[].textstringnullable

What it says.

data[].authorstringnullable

Its author's username, without u/.

data[].scoreintegernullable

Upvotes minus downvotes.

data[].created_atstringnullable

When it was posted.

format: date-time

data[].more_repliesintegernullable

How many replies its "more replies" link hides. Get them with this comment's id as comment_id.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/reddit/posts/comments?post_id=1wkziub' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": [    {      "id": "string",      "url": "string",      "post_id": "string",      "parent_id": "string",      "depth": 0,      "text": "string",      "author": "string",      "score": 0,      "created_at": "2019-08-24T14:15:22Z",      "more_replies": 0    }  ],  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}

Posts across Reddit that match a search.

Post transcript

The captions of a post's video, as one text and as timed segments. A post without them answers NOT_FOUND.