Search comments — Reddit API

Searches public Reddit comments, optionally limited to one or more subreddits. Supports relevance, new, and top sorting.

Get free API key View the docs

GET/v1/reddit/search/comments1 credit per request

Example response200OK

{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "OrderedCollectionPage",
    "partOf": "https://api.konbiniapi.com/v1/reddit/search/comments?query=community%20values",
    "totalItems": 1309,
    "cursor": null,
    "nextCursor": "MjU=",
    "next": "https://api.konbiniapi.com/v1/reddit/search/comments?query=community%20values&cursor=MjU%3D&count=25&order=new",
    "itemCount": 30,
    "orderedItems": [
      {
        "type": "Note",
        "id": "https://www.reddit.com/r/reddit/comments/suvhyq/reddit_community_values/hxcf648/",
        "url": "https://www.reddit.com/r/reddit/comments/suvhyq/reddit_community_values/hxcf648/",
        "entityId": "hxcf648",
        "content": "Hi everyone,\n\nHere is the [Talk](https://www.reddit.com/talk/9acbd3a2-99ef-4820-893f-fcf23ff8a541). I'll do my best to address some of the more nuanced questions live.\n\n(It's our first time using this format, bear with us!)",
        "published": "2022-02-17T19:06:31.000Z",
        "isPinned": true,
        "isSponsored": false,
        "hasReplies": true,
        "likeCount": 1,
        "score": 1,
        "voteCount": 1,
        "isControversial": false,
        "attributedTo": {
          "type": "Person",
          "id": "https://www.reddit.com/user/spez/",
          "url": "https://www.reddit.com/user/spez/",
          "preferredUsername": "spez",
          "name": "spez",
          "isPremium": true,
          "role": "admin",
          "tag": [
            {
              "type": "Tag",
              "name": "reddit",
              "href": "https://www.reddit.com/r/reddit/",
              "icon": {
                "type": "Image",
                "url": "https://external-preview.redd.it/WSqGR2511AQXIN172aycw9idD-3ENHc5hT_1a0M_2UQ.jpg?auto=webp&s=e4d15f89f1797d8111aeddd772534952d0adae50",
                "entityId": "nYKpDhp2hxECJAtPQcH3bEnaXSyk_O8cQKeLCmKEzyw",
                "width": 1536,
                "height": 528
              }
            }
          ]
        },
        "inReplyTo": "https://www.reddit.com/r/reddit/comments/suvhyq/reddit_community_values/",
        "context": {
          "type": "Note",
          "id": "https://www.reddit.com/r/reddit/comments/suvhyq/reddit_community_values/",
          "url": "https://www.reddit.com/r/reddit/comments/suvhyq/reddit_community_values/",
          "name": "Reddit Community Values",
          "attributedTo": {
            "type": "Person",
            "id": "https://www.reddit.com/user/spez/",
            "url": "https://www.reddit.com/user/spez/",
            "preferredUsername": "spez",
            "name": "spez",
            "isPremium": true,
            "role": "admin",
            "tag": [
              {
                "type": "Tag",
                "name": "reddit",
                "href": "https://www.reddit.com/r/reddit/",
                "icon": {
                  "type": "Image",
                  "url": "https://external-preview.redd.it/WSqGR2511AQXIN172aycw9idD-3ENHc5hT_1a0M_2UQ.jpg?auto=webp&s=e4d15f89f1797d8111aeddd772534952d0adae50",
                  "entityId": "nYKpDhp2hxECJAtPQcH3bEnaXSyk_O8cQKeLCmKEzyw",
                  "width": 1536,
                  "height": 528
                }
              }
            ]
          }
        },
        "image": {
          "type": "Image",
          "url": "https://external-preview.redd.it/WSqGR2511AQXIN172aycw9idD-3ENHc5hT_1a0M_2UQ.jpg?auto=webp&s=e4d15f89f1797d8111aeddd772534952d0adae50",
          "entityId": "nYKpDhp2hxECJAtPQcH3bEnaXSyk_O8cQKeLCmKEzyw",
          "width": 1536,
          "height": 528
        },
        "attachment": [
          {
            "type": "Image",
            "url": "https://external-preview.redd.it/WSqGR2511AQXIN172aycw9idD-3ENHc5hT_1a0M_2UQ.jpg?auto=webp&s=e4d15f89f1797d8111aeddd772534952d0adae50",
            "entityId": "nYKpDhp2hxECJAtPQcH3bEnaXSyk_O8cQKeLCmKEzyw",
            "width": 1536,
            "height": 528
          }
        ]
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/reddit/search/comments. Authentication and error conventions stay consistent across endpoints. This page shows the path, parameters, response shape, limits, and credit rule for this operation.

Built for

Data Analytics
Market Research
Platform Integration

Full reference for this endpoint

const response = await fetch("https://api.konbiniapi.com/v1/reddit/search/comments?query=reddit+community+values", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});

const data = await response.json();

Parameters5

queryrequiredIn · QueryType · stringSearch query. Supports author:name, "phrase" and -word to exclude
subredditsIn · QueryType · stringComma-separated subreddit names to search within
countIn · QueryType · integerNumber of comments to fetch (maximum: 100)1–100default 25
cursorIn · QueryType · stringPagination cursor
orderIn · QueryType · stringSort order: relevance (default), new, or toprelevance | new | topdefault relevance

What you will probably call next.

The Reddit endpoints around this one — the same object at a different depth, or the same kind of read.

All Reddit endpoints Browse every platform

Try it on your own data.

Get a free API key and make this request in minutes. Failed and timed-out requests are automatically refunded.

Get free API key Endpoint reference