String docs
Site integrations

Reddit

Reddit posts with their full comment trees, post and comment search with subreddit, sort and time filters, a subreddit's hot, new, top, rising or controversial listing, one account's profile with its posts and comments, and Reddit Reviews product pages: Reddit's AI summary of what people say about a product, its sentiment split, takeaways and source comments.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: reddit
  • Version: 1.3.0
  • Reads from: www.reddit.com
ActionDescriptionListed price
postRead one Reddit post and its full comment tree: every reply, however deep, including the branches Reddit collapses behind "more replies". Returns one row: the post (title, author, body, score, comment count, flair, link) and its comments depth first, each with its parent, depth, author, body, score and time. Large threads take several pages; maxPages bounds them, and complete says whether the tree was read to the end. A post id Reddit has no post for fails as not found.$0.001 per row
searchSearch Reddit posts by keyword, across Reddit or within one subreddit, sorted by relevance, hot, top, new or most comments, optionally limited to the last hour, day, week, month or year. Each row is a full post: title, author, subreddit, body, link, score, upvote ratio, comment count and flair. One search returns up to 500 posts, all Reddit serves for it; narrow the query, subreddit or time window to reach others. Results exclude NSFW posts, as Reddit's logged-out search does.$0.001 per row
comment-searchSearch Reddit comments by keyword, across Reddit or within one subreddit, sorted by relevance, top or new, optionally limited to the last hour, day, week, month or year. Each row is one comment: its text, author, score, creation and edit time, parent, link, and the post it is on (title, subreddit, author, score, comment count, link). One search returns up to 250 comments. Results exclude NSFW content, as Reddit's logged-out search does.$0.001 per row
subredditList a subreddit's posts in the order Reddit shows them: hot, new, top, rising, controversial or best, with a time range for top and controversial. Each row is a full post, the same as search returns: title, author, body, link, score, upvote ratio, comment count and flair. About 25 posts per page after a short first page; pinned posts come first, as on the site. A subreddit that does not exist, or that Reddit bans, keeps private or quarantines, fails with that reason.$0.001 per row
reviewsRead a product's Reddit Reviews page, Reddit's AI summary of what people say about the product. Returns one row: the product, its category, Reddit's summary, how many conversations it draws on and how they split positive, mixed and negative, the takeaways with their tone and cited comments, retailers and prices, related products, and the source comments themselves up to the conversations limit. A product id Reddit has no review page for fails as not found.$0.001 per row
userRead one Reddit account: its profile (display name, bio, icon, cake day) and the posts and comments it wrote, newest first or by top, hot or controversial, each with its text, subreddit, score, timestamps and link; comments carry the post they are on. Reddit lists about 1,000 posts and 1,000 comments per account at most.$0.001 per row

post

Read one Reddit post and its full comment tree: every reply, however deep, including the branches Reddit collapses behind "more replies". Returns one row: the post (title, author, body, score, comment count, flair, link) and its comments depth first, each with its parent, depth, author, body, score and time. Large threads take several pages; maxPages bounds them, and complete says whether the tree was read to the end. A post id Reddit has no post for fails as not found.

POST https://request.usestring.ai/v1/integrations/reddit/post

Input

Unknown fields are rejected.

FieldTypeDescription
poststringRequired. The post: its URL, such as https://www.reddit.com/r/technology/comments/1xapaw7/, a redd.it link, its id 1xapaw7 or its fullname t3_1xapaw7. A URL ending in .json works too. At least 1 character.
sortbest top new old controversial qaComment order: best (the default, Reddit's own), top, new, old, controversial or qa.
maxPagesintegerThe most comment pages to read, 1 to 100. A page is up to 200 comments, or one collapsed reply branch. Defaults to 20. From 1 to 100.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
postobject—
post.idstringThe post's base36 id, as in reddit.com/comments/<id>.
post.fullnamestringThe post's fullname, t3_<id>.
post.subredditstringThe subreddit's name without r/.
post.subredditIdstringThe subreddit's fullname, t5_<id>.
post.titlestring—
post.authorstring | nullThe author's username; null when the account is deleted or suspended.
post.authorIdstring | nullThe author's fullname, t2_<id>.
post.createdAtstringWhen the post was submitted, ISO 8601 in UTC.
post.editedAtstring | nullWhen the post was last edited, ISO 8601 in UTC; null if never.
post.scoreintegerUpvotes minus downvotes, as Reddit shows it.
post.upvoteRationumber | nullThe share of votes that are upvotes, 0 to 1.
post.commentCountinteger—
post.permalinkstringThe post's page on www.reddit.com.
post.urlstringWhat the post links to; the post's own page for a text post.
post.domainstringThe linked site's domain, or self.<subreddit> for a text post.
post.isSelfbooleanTrue for a text post.
post.bodystring | nullA text post's body as Markdown; null for a link, image or video post without text.
post.flairstring | nullThe post's flair text.
post.thumbnailstring | nullThe post's thumbnail image URL.
post.isNsfwboolean—
post.isSpoilerboolean—
post.isLockedboolean—
post.isStickiedboolean—
post.isArchivedboolean—
post.distinguishedstring | nullmoderator or admin when the author posted in that role.
post.removedBystring | nullWhy the post is removed, such as moderator, author or deleted; null when it is not.
post.languagestring | nullThe post's language as Reddit detected it, such as en; und (undetermined) when Reddit could not tell, as for many link and image posts with little text.
commentsobject[]Every comment read, depth first in the chosen order: each comment is followed by its replies.
comments[].idstringThe comment's base36 id.
comments[].fullnamestringThe comment's fullname, t1_<id>.
comments[].postIdstringThe post's fullname, t3_<id>.
comments[].parentIdstringThe parent comment's fullname, or the post's for a top-level comment.
comments[].depthinteger0 for a top-level comment, 1 for a reply to one, and so on.
comments[].authorstring | nullThe author's username; null when the account is deleted or suspended.
comments[].authorIdstring | nullThe author's fullname, t2_<id>.
comments[].bodystring | nullThe comment as Markdown; null when it is deleted or removed.
comments[].createdAtstringISO 8601 in UTC.
comments[].editedAtstring | nullISO 8601 in UTC; null if never edited.
comments[].scoreinteger | nullUpvotes minus downvotes; null while the subreddit hides a new comment's score.
comments[].isSubmitterbooleanTrue when the post's author wrote the comment.
comments[].isStickiedboolean—
comments[].distinguishedstring | nullmoderator or admin when the author commented in that role.
comments[].removedBystring | nullWhy the comment is removed; null when it is not.
comments[].permalinkstringThe comment's page on www.reddit.com.
comments[].replyCountintegerDirect replies Reddit counts for the comment, loaded or not.
completebooleanTrue when every comment Reddit serves for the post was read; false when maxPages ran out first.

Example

curl https://request.usestring.ai/v1/integrations/reddit/post \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "post": "https://www.reddit.com/r/MaticRobots/comments/1wxjx5g/bag_pass_and_matic_care_are_getting_more/",
    "maxPages": 3
  }'

data starts with these rows:

[
  {
    "post": {
      "id": "1wxjx5g",
      "fullname": "t3_1wxjx5g",
      "subreddit": "MaticRobots",
      "subredditId": "t5_9uh9zm",
      "title": "Bag Pass and Matic Care are getting more expensive tomorrow",
      "author": "IrishSpring",
      "authorId": "t2_64j5h",
      "createdAt": "2026-10-04T16:30:47Z",
      "editedAt": null,
      "score": 16,
      "upvoteRatio": 0.9444444444444444,
      "commentCount": 31,
      "permalink": "https://www.reddit.com/r/MaticRobots/comments/1wxjx5g/bag_pass_and_matic_care_are_getting_more/",
      "url": "https://www.reddit.com/r/MaticRobots/comments/1wxjx5g/bag_pass_and_matic_care_are_getting_more/",
      "domain": "self.MaticRobots",
      "isSelf": true,
      "body": "I just got an email from Matic that the bag pass and Matic Care extended warranty are getting more expensive due to tariffs and components costs.\n\n\"Annual Bag P…",
      "flair": "Discussion",
      "thumbnail": null,
      "isNsfw": false,
      "isSpoiler": false,
      "isLocked": false,
      "isStickied": false,
      "isArchived": false,
      "distinguished": null,
      "removedBy": null,
      "language": "en"
    },
    "comments": [
      {
        "id": "pdvm9qq",
        "fullname": "t1_pdvm9qq",
        "postId": "t3_1wxjx5g",
        "parentId": "t3_1wxjx5g",
        "depth": 0,
        "author": "branden3112",
        "authorId": "t2_6jssp",
        "body": "Can bag passes be stacked to have multiple years worth?",
        "createdAt": "2026-10-04T20:13:43Z",
        "editedAt": null,
        "score": 6,
        "isSubmitter": false,
        "isStickied": false,
        "distinguished": null,
        "removedBy": null,
        "permalink": "https://www.reddit.com/r/MaticRobots/comments/1wxjx5g/bag_pass_and_matic_care_are_getting_more/pdvm9qq/",
        "replyCount": 1
      },
      {
        "id": "pdwqaxr",
        "fullname": "t1_pdwqaxr",
        "postId": "t3_1wxjx5g",
        "parentId": "t1_pdvm9qq",
        "depth": 1,
        "author": "IrishSpring",
        "authorId": "t2_64j5h",
        "body": "+1",
        "createdAt": "2026-10-04T23:16:55Z",
        "editedAt": null,
        "score": 2,
        "isSubmitter": true,
        "isStickied": false,
        "distinguished": null,
        "removedBy": null,
        "permalink": "https://www.reddit.com/r/MaticRobots/comments/1wxjx5g/bag_pass_and_matic_care_are_getting_more/pdwqaxr/",
        "replyCount": 0
      },
      {
        "id": "pdu3k7k",
        "fullname": "t1_pdu3k7k",
        "postId": "t3_1wxjx5g",
        "parentId": "t3_1wxjx5g",
        "depth": 0,
        "author": "IrishSpring",
        "authorId": "t2_64j5h",
        "body": "Here's the full email\n\n![img](vx9xv17j9hth1)",
        "createdAt": "2026-10-04T16:31:36Z",
        "editedAt": null,
        "score": 2,
        "isSubmitter": true,
        "isStickied": false,
        "distinguished": null,
        "removedBy": null,
        "permalink": "https://www.reddit.com/r/MaticRobots/comments/1wxjx5g/bag_pass_and_matic_care_are_getting_more/pdu3k7k/",
        "replyCount": 0
      }
    ],
    "complete": true
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page, plus up to 2 setup requests per call.
  • Billing: perRow, $0.001 per row with the requests it makes included: billing.rows is the rows a call is charged for, and a call with no rows costs nothing. See Pricing.

Search Reddit posts by keyword, across Reddit or within one subreddit, sorted by relevance, hot, top, new or most comments, optionally limited to the last hour, day, week, month or year. Each row is a full post: title, author, subreddit, body, link, score, upvote ratio, comment count and flair. One search returns up to 500 posts, all Reddit serves for it; narrow the query, subreddit or time window to reach others. Results exclude NSFW posts, as Reddit's logged-out search does.

POST https://request.usestring.ai/v1/integrations/reddit/search

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. What to search for, as typed in Reddit's search box. At least 1 character.
subredditstringOnly posts in this subreddit: its name, such as technology, or r/technology.
sortrelevance hot top new commentsrelevance (the default), hot, top, new or comments (most commented)
timehour day week month year allOnly posts from the last hour, day, week, month or year, or all (the default)
limitintegerThe most posts to return, 1 to 500. Defaults to 500, all Reddit serves for one search. From 1 to 500.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstringThe post's base36 id, as in reddit.com/comments/<id>.
fullnamestringThe post's fullname, t3_<id>.
subredditstringThe subreddit's name without r/.
subredditIdstringThe subreddit's fullname, t5_<id>.
titlestring—
authorstring | nullThe author's username; null when the account is deleted or suspended.
authorIdstring | nullThe author's fullname, t2_<id>.
createdAtstringWhen the post was submitted, ISO 8601 in UTC.
editedAtstring | nullWhen the post was last edited, ISO 8601 in UTC; null if never.
scoreintegerUpvotes minus downvotes, as Reddit shows it.
upvoteRationumber | nullThe share of votes that are upvotes, 0 to 1.
commentCountinteger—
permalinkstringThe post's page on www.reddit.com.
urlstringWhat the post links to; the post's own page for a text post.
domainstringThe linked site's domain, or self.<subreddit> for a text post.
isSelfbooleanTrue for a text post.
bodystring | nullA text post's body as Markdown; null for a link, image or video post without text.
flairstring | nullThe post's flair text.
thumbnailstring | nullThe post's thumbnail image URL.
isNsfwboolean—
isSpoilerboolean—
isLockedboolean—
isStickiedboolean—
isArchivedboolean—
distinguishedstring | nullmoderator or admin when the author posted in that role.
removedBystring | nullWhy the post is removed, such as moderator, author or deleted; null when it is not.
languagestring | nullThe post's language as Reddit detected it, such as en; und (undetermined) when Reddit could not tell, as for many link and image posts with little text.

Example

curl https://request.usestring.ai/v1/integrations/reddit/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "robot vacuum",
    "subreddit": "MaticRobots",
    "sort": "new"
  }'

data starts with these rows:

[
  {
    "id": "1x8dyli",
    "fullname": "t3_1x8dyli",
    "subreddit": "MaticRobots",
    "subredditId": "t5_9uh9zm",
    "title": "Brand new Mattic Robot making clicking noise",
    "author": "Pingfao",
    "authorId": "t2_104igt",
    "createdAt": "2026-10-17T16:06:18Z",
    "editedAt": null,
    "score": 5,
    "upvoteRatio": 0.8571428571428571,
    "commentCount": 19,
    "permalink": "https://www.reddit.com/r/MaticRobots/comments/1x8dyli/brand_new_mattic_robot_making_clicking_noise/",
    "url": "https://v.redd.it/q0y3v9luw1wh1",
    "domain": "v.redd.it",
    "isSelf": false,
    "body": "Sharing to see if this is normal. We just got our Matic yesterday. The vacuuming and mopping itself is quiet but there's a weird clicking noise when it's cleani…",
    "flair": "Bug / Issue",
    "thumbnail": "https://external-preview.redd.it/cmg3MmIzanV3MXdoMU32WJgmPKSvMfnYrsqG86Pw_3Wngtej-loEIkZAe9N3.png?width=140&height=140&crop=1%3A1%2Csmart&format=jpg&auto=webp&s=f25ebd6a9472f4b688e6a87e834f55ad1c517b48",
    "isNsfw": false,
    "isSpoiler": false,
    "isLocked": false,
    "isStickied": false,
    "isArchived": false,
    "distinguished": null,
    "removedBy": null,
    "language": "en"
  }
]

Requests and billing

  • Requests: 1 Web Access request per call, plus up to 1 setup request per call.
  • Billing: perRow, $0.001 per row with the requests it makes included: billing.rows is the rows a call is charged for, and a call with no rows costs nothing. See Pricing.

Search Reddit comments by keyword, across Reddit or within one subreddit, sorted by relevance, top or new, optionally limited to the last hour, day, week, month or year. Each row is one comment: its text, author, score, creation and edit time, parent, link, and the post it is on (title, subreddit, author, score, comment count, link). One search returns up to 250 comments. Results exclude NSFW content, as Reddit's logged-out search does.

POST https://request.usestring.ai/v1/integrations/reddit/comment-search

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. What to search comments for, as typed in Reddit's search box. At least 1 character.
subredditstringOnly comments in this subreddit: its name, such as technology, or r/technology.
sortrelevance top newrelevance (the default), top or new.
timehour day week month year allOnly comments from the last hour, day, week, month or year, or all (the default)
limitintegerThe most comments to return, 1 to 250. Defaults to 100. From 1 to 250.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstringThe comment's base36 id.
fullnamestringThe comment's fullname, t1_<id>.
parentIdstringThe parent comment's fullname, or the post's for a top-level comment.
authorstring | nullThe author's username; null when the account is deleted or suspended.
authorIdstring | nullThe author's fullname, t2_<id>.
bodystring | nullThe comment as Markdown; null when it is deleted or removed.
createdAtstringISO 8601 in UTC.
editedAtstring | nullISO 8601 in UTC; null if never edited.
scoreinteger | nullUpvotes minus downvotes; null while the subreddit hides a new comment's score.
isSubmitterbooleanTrue when the post's author wrote the comment.
permalinkstringThe comment's page on www.reddit.com.
postobjectThe post the comment is on.
post.idstringThe post's base36 id, as in reddit.com/comments/<id>.
post.fullnamestringThe post's fullname, t3_<id>.
post.subredditstringThe subreddit's name without r/.
post.subredditIdstringThe subreddit's fullname, t5_<id>.
post.titlestring—
post.authorstring | nullThe post author's username; null when the account is deleted or suspended.
post.authorIdstring | nullThe post author's fullname, t2_<id>.
post.createdAtstringWhen the post was submitted, ISO 8601 in UTC.
post.scoreintegerUpvotes minus downvotes, as Reddit shows it.
post.commentCountinteger—
post.permalinkstringThe post's page on www.reddit.com.
post.urlstringWhat the post links to; the post's own page for a text post.
post.domainstringThe linked site's domain, or self.<subreddit> for a text post.
post.isSelfbooleanTrue for a text post.
post.flairstring | nullThe post's flair text.
post.isNsfwboolean—
post.isSpoilerboolean—
post.languagestring | nullThe post's language as Reddit detected it, such as en.

Example

curl https://request.usestring.ai/v1/integrations/reddit/comment-search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mechanix gloves",
    "sort": "new",
    "limit": 25
  }'

data starts with these rows:

[
  {
    "id": "19rrp4k0ljdr6",
    "fullname": "t1_19rrp4k0ljdr6",
    "parentId": "t1_19rr46dc60odc",
    "author": "Mucking_Fuddled",
    "authorId": "t2_15lydk",
    "body": "Loads of people go for Mechanix, but they cost a fair bit. Got mine from Mountain Warehouse, just a decent pair of light-weight thermal gloves that were on sale…",
    "createdAt": "2026-10-28T06:44:03Z",
    "editedAt": null,
    "score": 1,
    "isSubmitter": false,
    "permalink": "https://www.reddit.com/r/ukpolice/comments/1xf621l/comment/19rrp4k0ljdr6/",
    "post": {
      "id": "1xf621l",
      "fullname": "t3_1xf621l",
      "subreddit": "ukpolice",
      "subredditId": "t5_2xwd7",
      "title": "What's something you have brought for work that is extremely useful but not standard issue?",
      "author": "BigBuoyPinky",
      "authorId": "t2_4ufh9tm0",
      "createdAt": "2026-10-25T15:59:46Z",
      "score": 2,
      "commentCount": 12,
      "permalink": "https://www.reddit.com/r/ukpolice/comments/1xf621l/",
      "url": "https://www.reddit.com/r/ukpolice/comments/1xf621l/whats_something_you_have_brought_for_work_that_is/",
      "domain": "self.ukpolice",
      "isSelf": true,
      "flair": "Question",
      "isNsfw": false,
      "isSpoiler": false,
      "language": "en"
    }
  }
]

Requests and billing

  • Requests: 1–3 Web Access requests per call, plus up to 1 setup request per call.
  • Billing: perRow, $0.001 per row with the requests it makes included: billing.rows is the rows a call is charged for, and a call with no rows costs nothing. See Pricing.

subreddit

List a subreddit's posts in the order Reddit shows them: hot, new, top, rising, controversial or best, with a time range for top and controversial. Each row is a full post, the same as search returns: title, author, body, link, score, upvote ratio, comment count and flair. About 25 posts per page after a short first page; pinned posts come first, as on the site. A subreddit that does not exist, or that Reddit bans, keeps private or quarantines, fails with that reason.

POST https://request.usestring.ai/v1/integrations/reddit/subreddit

Input

Unknown fields are rejected.

FieldTypeDescription
subredditstringRequired. The subreddit: its name, such as technology, r/technology, or its URL. A URL ending in .json works too. At least 1 character.
sorthot new top rising controversial besthot (the default), new, top, rising, controversial or best.
timehour day week month year allFor top and controversial: the last hour, day, week, month or year, or all. Reddit's default is day.
maxPagesintegerThe most listing pages to read, 1 to 40, the first about 7 posts and each later one about 25. Defaults to 5 (about 100 posts) From 1 to 40.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstringThe post's base36 id, as in reddit.com/comments/<id>.
fullnamestringThe post's fullname, t3_<id>.
subredditstringThe subreddit's name without r/.
subredditIdstringThe subreddit's fullname, t5_<id>.
titlestring—
authorstring | nullThe author's username; null when the account is deleted or suspended.
authorIdstring | nullThe author's fullname, t2_<id>.
createdAtstringWhen the post was submitted, ISO 8601 in UTC.
editedAtstring | nullWhen the post was last edited, ISO 8601 in UTC; null if never.
scoreintegerUpvotes minus downvotes, as Reddit shows it.
upvoteRationumber | nullThe share of votes that are upvotes, 0 to 1.
commentCountinteger—
permalinkstringThe post's page on www.reddit.com.
urlstringWhat the post links to; the post's own page for a text post.
domainstringThe linked site's domain, or self.<subreddit> for a text post.
isSelfbooleanTrue for a text post.
bodystring | nullA text post's body as Markdown; null for a link, image or video post without text.
flairstring | nullThe post's flair text.
thumbnailstring | nullThe post's thumbnail image URL.
isNsfwboolean—
isSpoilerboolean—
isLockedboolean—
isStickiedboolean—
isArchivedboolean—
distinguishedstring | nullmoderator or admin when the author posted in that role.
removedBystring | nullWhy the post is removed, such as moderator, author or deleted; null when it is not.
languagestring | nullThe post's language as Reddit detected it, such as en; und (undetermined) when Reddit could not tell, as for many link and image posts with little text.

Example

curl https://request.usestring.ai/v1/integrations/reddit/subreddit \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "MaticRobots",
    "sort": "new",
    "maxPages": 1
  }'

data starts with these rows:

[
  {
    "id": "1xafajp",
    "fullname": "t3_1xafajp",
    "subreddit": "MaticRobots",
    "subredditId": "t5_9uh9zm",
    "title": "Holiday Sales?",
    "author": "Jazzlike_Rich_9275",
    "authorId": "t2_co3yzo0u",
    "createdAt": "2026-10-20T01:37:33Z",
    "editedAt": null,
    "score": 3,
    "upvoteRatio": 1,
    "commentCount": 4,
    "permalink": "https://www.reddit.com/r/MaticRobots/comments/1xafajp/holiday_sales/",
    "url": "https://www.reddit.com/r/MaticRobots/comments/1xafajp/holiday_sales/",
    "domain": "self.MaticRobots",
    "isSelf": true,
    "body": "Any plans for Black Friday or holiday sales this year? I’ve been considering purchasing a Matic for a while and really regret not pulling the trigger before the…",
    "flair": "Other",
    "thumbnail": null,
    "isNsfw": false,
    "isSpoiler": false,
    "isLocked": false,
    "isStickied": false,
    "isArchived": false,
    "distinguished": null,
    "removedBy": null,
    "language": "en"
  },
  {
    "id": "1xad50k",
    "fullname": "t3_1xad50k",
    "subreddit": "MaticRobots",
    "subredditId": "t5_9uh9zm",
    "title": "Need More Convenient “Job” Options",
    "author": "Muhahahahaz",
    "authorId": "t2_i3w9f",
    "createdAt": "2026-10-19T23:57:44Z",
    "editedAt": null,
    "score": 8,
    "upvoteRatio": 1,
    "commentCount": 2,
    "permalink": "https://www.reddit.com/r/MaticRobots/comments/1xad50k/need_more_convenient_job_options/",
    "url": "https://i.redd.it/tp9mjxssiiwh1.jpeg",
    "domain": "i.redd.it",
    "isSelf": false,
    "body": "It would be really nice to have a “Start Now” option for this impending job. (Or at the very least, let me schedule it for any arbitrary time I want? Rather tha…",
    "flair": "New Feature",
    "thumbnail": "https://preview.redd.it/tp9mjxssiiwh1.jpeg?width=140&height=140&crop=1%3A1%2Csmart&auto=webp&s=ff0ca09058aa38b48b6c0c5d4d67b917c1ce26d1",
    "isNsfw": false,
    "isSpoiler": false,
    "isLocked": false,
    "isStickied": false,
    "isArchived": false,
    "distinguished": null,
    "removedBy": null,
    "language": "en"
  }
]

Requests and billing

  • Requests: 1–2 Web Access requests per result page, plus up to 1 setup request per call.
  • Billing: perRow, $0.001 per row with the requests it makes included: billing.rows is the rows a call is charged for, and a call with no rows costs nothing. See Pricing.

reviews

Read a product's Reddit Reviews page, Reddit's AI summary of what people say about the product. Returns one row: the product, its category, Reddit's summary, how many conversations it draws on and how they split positive, mixed and negative, the takeaways with their tone and cited comments, retailers and prices, related products, and the source comments themselves up to the conversations limit. A product id Reddit has no review page for fails as not found.

POST https://request.usestring.ai/v1/integrations/reddit/reviews

Input

Unknown fields are rejected.

FieldTypeDescription
productstringRequired. The product: its Reddit Reviews URL, such as https://www.reddit.com/reviews/Sksz/espresso-machines/product/M0Z3/nespresso-vertuoplus/, or its id M0Z3. At least 1 character.
conversationsintegerThe most source comments to return, 1 to 1000. Defaults to 50. From 1 to 1000.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstringThe product's Reddit Reviews id, such as M0Z3.
titlestring—
urlstringThe product's Reddit Reviews page.
categoryobject—
category.idstring—
category.namestring—
parentCategoryobject | nullThe category above it; null at the top.
parentCategory.idstring—
parentCategory.namestring—
descriptionstring | nullWhat the product is, in Reddit's words.
summarystring | nullReddit's AI summary of what people are saying about the product.
imageUrlstring | null—
pricestring | nullThe price Reddit shows, formatted, such as $219.00.
mentionCountintegerReddit conversations the review is built from: the positive, mixed and negative counts summed.
sentimentobject | nullHow those conversations split; null when Reddit shows no split.
sentiment.positiveinteger—
sentiment.mixedinteger—
sentiment.negativeinteger—
sentiment.overallstring | nullpositive, mixed or negative, as Reddit rates the product overall.
sentiment.labelstring | nullReddit's wording of the overall tone, such as Very positive.
takeawaysobject[]The themes Reddit draws out, each with its tone and the comments behind it.
takeaways[].titlestring—
takeaways[].sentimentstring | nullpositive, mixed or negative.
takeaways[].commentsobject[] | nullThe comments Reddit cites for the theme.
takeaways[].comments[].idstringThe comment's base36 id.
takeaways[].comments[].fullnamestringThe comment's fullname, t1_<id>.
takeaways[].comments[].postIdstringThe post's fullname, t3_<id>.
takeaways[].comments[].subredditstringThe subreddit's name without r/.
takeaways[].comments[].textstring | nullThe comment's opening, up to about 300 characters, as the review shows it; the post action reads the full comment.
takeaways[].comments[].scoreinteger | nullUpvotes minus downvotes; null while the subreddit hides it.
takeaways[].comments[].permalinkstringThe comment's page on www.reddit.com.
retailersobject[]Where Reddit says the product is sold, with each retailer's price.
retailers[].namestring—
retailers[].pricestring | nullFormatted, such as $219.00.
retailers[].urlstringThe retailer's product page, as Reddit links it.
communityCountintegerSubreddits the conversations come from.
communitiesstring[]The subreddits Reddit lists first on the page, without r/.
topicsstring[]The topics Reddit lets readers filter conversations by.
relatedobject[]Products Reddit shows alongside this one.
related[].idstring—
related[].titlestring—
related[].pricestring | null—
related[].sentimentobject | null—
related[].sentiment.positiveinteger—
related[].sentiment.mixedinteger—
related[].sentiment.negativeinteger—
related[].sentiment.overallstring | nullpositive, mixed or negative, as Reddit rates the product overall.
related[].sentiment.labelstring | nullReddit's wording of the overall tone, such as Very positive.
conversationsobject[]Source comments in Reddit's order, up to the conversations limit.
conversations[].idstringThe comment's base36 id.
conversations[].fullnamestringThe comment's fullname, t1_<id>.
conversations[].postIdstringThe post's fullname, t3_<id>.
conversations[].subredditstringThe subreddit's name without r/.
conversations[].textstring | nullThe comment's opening, up to about 300 characters, as the review shows it; the post action reads the full comment.
conversations[].scoreinteger | nullUpvotes minus downvotes; null while the subreddit hides it.
conversations[].permalinkstringThe comment's page on www.reddit.com.
completebooleanTrue when every conversation Reddit lists was read; false when the conversations limit came first.

Example

curl https://request.usestring.ai/v1/integrations/reddit/reviews \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "https://www.reddit.com/reviews/Sksz/espresso-machines/product/M0Z3/nespresso-vertuoplus/",
    "conversations": 35
  }'

data starts with these rows:

[
  {
    "id": "M0Z3",
    "title": "Nespresso VertuoPlus",
    "url": "https://www.reddit.com/reviews/Sksz/espresso-machines/product/M0Z3/nespresso-vertuoplus/",
    "category": {
      "id": "Sksz",
      "name": "Espresso Machines"
    },
    "parentCategory": {
      "id": "bGt6",
      "name": "Coffee Makers & Espresso Machines"
    },
    "description": "A single-serve coffee and espresso machine from Nespresso that uses Centrifusion technology to brew different-sized drinks from pods. The machine reads a barcode on each pod to automatically adjust brewing parameters for that specific blend.",
    "summary": "The VertuoPlus holds up for years of daily use, features a large water tank, and is simple to open and close. However, it lacks support for newer pod sizes and modes, and while coffee tastes very good to many, it tastes bad for some.",
    "imageUrl": "https://i.redd.it/1tkz2fav02ff1.jpeg",
    "price": "$219.00",
    "mentionCount": 415,
    "sentiment": {
      "positive": 305,
      "mixed": 40,
      "negative": 70,
      "overall": "positive",
      "label": "Positive"
    },
    "takeaways": [
      {
        "title": "Holds up for years of daily use",
        "sentiment": "positive",
        "comments": [
          {
            "id": "p4nqndh",
            "fullname": "t1_p4nqndh",
            "postId": "t3_1vssnxx",
            "subreddit": "nespresso",
            "text": "It depends a little on what you want to do with it. The Vertuo Plus is a machine with a great track record. Mine has been going strong for 5+ years with 2-5 use…",
            "score": 8,
            "permalink": "https://www.reddit.com/r/nespresso/comments/1vssnxx/comment/p4nqndh/"
          }
        ]
      },
      {
        "title": "Simple to open and close",
        "sentiment": "positive",
        "comments": [
          {
            "id": "odm73x0",
            "fullname": "t1_odm73x0",
            "postId": "t3_1s93ocn",
            "subreddit": "nespresso",
            "text": "Sur la Table also has the DeLonghi branded Vertuo Plus. I bought 2 last year, one for work to replace a Pop and one for home to replace a Next that was crap. I…",
            "score": 0,
            "permalink": "https://www.reddit.com/r/nespresso/comments/1s93ocn/comment/odm73x0/"
          }
        ]
      }
    ],
    "retailers": [
      {
        "name": "Wayfair",
        "price": "$219.00",
        "url": "https://www.wayfair.com/Nespresso--Nespresso-VertuoPlus-Espresso-Machine-by-DeLonghi-with-Aeroccino-Milk-Frother-ENV150GYAE-L914-K~DLG2564.html?PiID%5B%5D=20734281&refid=RDTRR"
      },
      {
        "name": "Amazon",
        "price": "$249.00",
        "url": "https://www.amazon.com/Nespresso-VertuoPlus-Espresso-DeLonghi-Aeroccino/dp/B01N1QSB6J?hvcampaign=redditps&ref=pd_sl_7qj8tz3lnb_p&tag=googhydr-20&utm_source=redditanswers"
      }
    ],
    "communityCount": 17,
    "communities": ["nespresso", "Albuquerque", "superautomatic", "DIY"],
    "topics": ["Brewing Versatility", "Coffee Taste", "Durability", "Lid Mechanism", "Water Reservoir"],
    "related": [
      {
        "id": "QzU0",
        "title": "Nespresso Essenza Mini",
        "price": "$189.00",
        "sentiment": {
          "positive": 212,
          "mixed": 22,
          "negative": 22,
          "overall": "positive",
          "label": "Very positive"
        }
      },
      {
        "id": "LXlR",
        "title": "Breville Barista Touch",
        "price": "$999.95",
        "sentiment": {
          "positive": 83,
          "mixed": 21,
          "negative": 47,
          "overall": "mixed",
          "label": "Mixed"
        }
      }
    ],
    "conversations": [
      {
        "id": "pd10yyc",
        "fullname": "t1_pd10yyc",
        "postId": "t3_1wu24am",
        "subreddit": "nespresso",
        "text": "This is why I took my OL out of storage and started buying non-Nespresso capsules. Plus, more variety. My Vertuo Plus, which I actually love, has switched place…",
        "score": 27,
        "permalink": "https://www.reddit.com/r/nespresso/comments/1wu24am/comment/pd10yyc/"
      },
      {
        "id": "19rg99ormigrl",
        "fullname": "t1_19rg99ormigrl",
        "postId": "t3_1xbv6xk",
        "subreddit": "nespresso",
        "text": "I have a Vertuo Plus by Breville. We're at four years strong with zero complaints. My friend has the same machine that I think is over 8 years old.",
        "score": 14,
        "permalink": "https://www.reddit.com/r/nespresso/comments/1xbv6xk/comment/19rg99ormigrl/"
      },
      {
        "id": "19sb5u8y1fg9x",
        "fullname": "t1_19sb5u8y1fg9x",
        "postId": "t3_1xqncqp",
        "subreddit": "nespresso",
        "text": "It wouldn’t be for me. I didn’t drink coffee before, but I bought my husband a Vertuo Plus Deluxe and I really like the convenience and the taste. If I see a go…",
        "score": 8,
        "permalink": "https://www.reddit.com/r/nespresso/comments/1xqncqp/comment/19sb5u8y1fg9x/"
      }
    ],
    "complete": false
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page, plus up to 1 setup request per call.
  • Billing: perRow, $0.001 per row with the requests it makes included: billing.rows is the rows a call is charged for, and a call with no rows costs nothing. See Pricing.

user

Read one Reddit account: its profile (display name, bio, icon, cake day) and the posts and comments it wrote, newest first or by top, hot or controversial, each with its text, subreddit, score, timestamps and link; comments carry the post they are on. Reddit lists about 1,000 posts and 1,000 comments per account at most.

POST https://request.usestring.ai/v1/integrations/reddit/user

Input

Unknown fields are rejected.

FieldTypeDescription
userstringRequired. The account: its username, u/name, or its www.reddit.com/user/\ URL. At least 1 character.
contentposts comments bothposts, comments, or both (the default)
sortnew top hot controversialnew (the default), top, hot or controversial.
timehour day week month year allWith top or controversial: only items from the last hour, day, week, month or year, or all (the default)
maxPagesintegerPages of 100 to read for each of posts and comments, 1 to 10. Defaults to 3. Reddit serves about 1,000 items of each at most. From 1 to 10.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
profileobject—
profile.namestringThe username, without u/.
profile.displayNamestring | nullThe display name the account set, if any.
profile.biostring | nullThe profile's description.
profile.iconUrlstring | null—
profile.bannerUrlstring | null—
profile.createdAtstring | nullThe account's cake day, the date it was created, ISO 8601 at midnight UTC; null when the profile page did not answer.
profile.profileSubredditCreatedAtstring | nullWhen the account's u_<name> profile subreddit was created, ISO 8601 in UTC; not the account's creation, and null for an account without one.
profile.isNsfwbooleanTrue when the account marked its profile NSFW.
profile.urlstringThe profile's page on www.reddit.com.
postsobject[] | nullThe account's posts, in the order asked.
posts[].idstringThe post's base36 id, as in reddit.com/comments/<id>.
posts[].fullnamestringThe post's fullname, t3_<id>.
posts[].subredditstringThe subreddit's name without r/.
posts[].subredditIdstringThe subreddit's fullname, t5_<id>.
posts[].titlestring—
posts[].authorstring | nullThe author's username; null when the account is deleted or suspended.
posts[].authorIdstring | nullThe author's fullname, t2_<id>.
posts[].createdAtstringWhen the post was submitted, ISO 8601 in UTC.
posts[].editedAtstring | nullWhen the post was last edited, ISO 8601 in UTC; null if never.
posts[].scoreintegerUpvotes minus downvotes, as Reddit shows it.
posts[].upvoteRationumber | nullThe share of votes that are upvotes, 0 to 1.
posts[].commentCountinteger—
posts[].permalinkstringThe post's page on www.reddit.com.
posts[].urlstringWhat the post links to; the post's own page for a text post.
posts[].domainstringThe linked site's domain, or self.<subreddit> for a text post.
posts[].isSelfbooleanTrue for a text post.
posts[].bodystring | nullA text post's body as Markdown; null for a link, image or video post without text.
posts[].flairstring | nullThe post's flair text.
posts[].thumbnailstring | nullThe post's thumbnail image URL.
posts[].isNsfwboolean—
posts[].isSpoilerboolean—
posts[].isLockedboolean—
posts[].isStickiedboolean—
posts[].isArchivedboolean—
posts[].distinguishedstring | nullmoderator or admin when the author posted in that role.
posts[].removedBystring | nullWhy the post is removed, such as moderator, author or deleted; null when it is not.
posts[].languagestring | nullThe post's language as Reddit detected it, such as en; und (undetermined) when Reddit could not tell, as for many link and image posts with little text.
commentsobject[] | nullThe account's comments, in the order asked.
comments[].idstringThe comment's base36 id.
comments[].fullnamestringThe comment's fullname, t1_<id>.
comments[].parentIdstringThe parent comment's fullname, or the post's for a top-level comment.
comments[].postIdstringThe post's fullname, t3_<id>.
comments[].postTitlestring—
comments[].postAuthorstring | nullThe post author's username; null when the account is deleted.
comments[].postPermalinkstringThe post's page on www.reddit.com.
comments[].subredditstringThe subreddit's name without r/.
comments[].subredditIdstringThe subreddit's fullname, t5_<id>.
comments[].bodystring | nullThe comment as Markdown; null when it is deleted or removed.
comments[].scoreinteger | nullUpvotes minus downvotes; null while the subreddit hides a new comment's score.
comments[].createdAtstringISO 8601 in UTC.
comments[].editedAtstring | nullISO 8601 in UTC; null if never edited.
comments[].permalinkstringThe comment's page on www.reddit.com.
comments[].isSubmitterbooleanTrue when the account also wrote the post.
comments[].isNsfwboolean—
comments[].distinguishedstring | nullmoderator or admin when the account commented in that role.
postsCompleteboolean | nullTrue when every post Reddit lists for the account was read; null when posts were not asked for.
commentsCompleteboolean | nullTrue when every comment Reddit lists for the account was read; null when comments were not asked for.

Example

curl https://request.usestring.ai/v1/integrations/reddit/user \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "spez",
    "maxPages": 1
  }'

data starts with these rows:

[
  {
    "profile": {
      "name": "spez",
      "displayName": "spez",
      "bio": "Reddit CEO",
      "iconUrl": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png",
      "bannerUrl": "https://b.thumbs.redditmedia.com/KWeEpVxXOGLoloMbM0IxGt9EiKPXizpwFgcSeWqtpZM.png",
      "createdAt": "2005-06-06T00:00:00Z",
      "profileSubredditCreatedAt": "2017-04-19T22:04:39Z",
      "isNsfw": false,
      "url": "https://www.reddit.com/user/spez/"
    },
    "posts": [
      {
        "id": "1xiupm0",
        "fullname": "t3_1xiupm0",
        "subreddit": "u_spez",
        "subredditId": "t5_3k30p",
        "title": "About that login screen",
        "author": "spez",
        "authorId": "t2_1w72",
        "createdAt": "2026-10-29T20:08:37Z",
        "editedAt": null,
        "score": 0,
        "upvoteRatio": 0.31,
        "commentCount": 505,
        "permalink": "https://www.reddit.com/user/spez/comments/1xiupm0/about_that_login_screen/",
        "url": "https://www.reddit.com/user/spez/comments/1xiupm0/about_that_login_screen/",
        "domain": "self.spez",
        "isSelf": true,
        "body": "I want to talk about a big change we're making on Reddit: we're going to evolve Reddit to being a primarily logged-in experience.\n\nThis is a big change for Redd…",
        "flair": null,
        "thumbnail": null,
        "isNsfw": false,
        "isSpoiler": false,
        "isLocked": false,
        "isStickied": false,
        "isArchived": false,
        "distinguished": "admin",
        "removedBy": null,
        "language": null
      },
      {
        "id": "1vgbkge",
        "fullname": "t3_1vgbkge",
        "subreddit": "u_spez",
        "subredditId": "t5_3k30p",
        "title": "Modernizing Reddit’s infrastructure with you",
        "author": "spez",
        "authorId": "t2_1w72",
        "createdAt": "2026-08-05T16:03:56Z",
        "editedAt": "2026-08-05T16:14:48Z",
        "score": 378,
        "upvoteRatio": 0.84,
        "commentCount": 494,
        "permalink": "https://www.reddit.com/user/spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/",
        "url": "https://www.reddit.com/user/spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/",
        "domain": "self.spez",
        "isSelf": true,
        "body": "Hi everyone,\n\nLast May, I shared how we were building Reddit for its [next chapter](https://www.reddit.com/user/spez/comments/1kfciml/reddits_next_chapter_smart…",
        "flair": null,
        "thumbnail": null,
        "isNsfw": false,
        "isSpoiler": false,
        "isLocked": false,
        "isStickied": false,
        "isArchived": false,
        "distinguished": "admin",
        "removedBy": null,
        "language": null
      }
    ],
    "comments": [
      {
        "id": "19ruo33ofgh8i",
        "fullname": "t1_19ruo33ofgh8i",
        "parentId": "t1_19rui7whi24p1",
        "postId": "t3_1xiupuc",
        "postTitle": "Reddit Announces Q3’26 Earnings (plus AMA!)",
        "postAuthor": "rddt_IR",
        "postPermalink": "https://www.reddit.com/r/RDDT/comments/1xiupuc/reddit_announces_q326_earnings_plus_ama/",
        "subreddit": "RDDT",
        "subredditId": "t5_akdezc",
        "body": "Pretty simple. For people who are already coming to Reddit every week, we have to give them a reason to come back everyday. If you come for sports and entertain…",
        "score": -7,
        "createdAt": "2026-10-29T22:42:06Z",
        "editedAt": null,
        "permalink": "https://www.reddit.com/r/RDDT/comments/1xiupuc/reddit_announces_q326_earnings_plus_ama/19ruo33ofgh8i/",
        "isSubmitter": false,
        "isNsfw": false,
        "distinguished": "admin"
      },
      {
        "id": "19ruo2bw7d6ps",
        "fullname": "t1_19ruo2bw7d6ps",
        "parentId": "t1_19ruhds72jakk",
        "postId": "t3_1xiupuc",
        "postTitle": "Reddit Announces Q3’26 Earnings (plus AMA!)",
        "postAuthor": "rddt_IR",
        "postPermalink": "https://www.reddit.com/r/RDDT/comments/1xiupuc/reddit_announces_q326_earnings_plus_ama/",
        "subreddit": "RDDT",
        "subredditId": "t5_akdezc",
        "body": "At a high level, however people want to communicate on the internet, they should be able to do so on Reddit.\n\nWe’ve continually evolved over the years, from jus…",
        "score": -10,
        "createdAt": "2026-10-29T22:41:37Z",
        "editedAt": null,
        "permalink": "https://www.reddit.com/r/RDDT/comments/1xiupuc/reddit_announces_q326_earnings_plus_ama/19ruo2bw7d6ps/",
        "isSubmitter": false,
        "isNsfw": false,
        "distinguished": "admin"
      }
    ],
    "postsComplete": true,
    "commentsComplete": false
  }
]

Requests and billing

  • Requests: 3–23 Web Access requests per call, plus up to 1 setup request per call.
  • Billing: perRow, $0.001 per row with the requests it makes included: billing.rows is the rows a call is charged for, and a call with no rows costs nothing. See Pricing.