Skip to main content
GET
https://yoinkit.ai/api/v1/openclaw
/
api
/
v1
/
openclaw
/
reddit
/
subreddit
/
search
Reddit Subreddit Search
curl --request GET \
  --url https://yoinkit.ai/api/v1/openclaw/api/v1/openclaw/reddit/subreddit/search \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "posts": [
      {}
    ],
    "comments": [
      {}
    ],
    "media": [
      {}
    ]
  },
  "meta": {}
}

Parameters

query
string
required
The search query to find content within the subreddit
subreddit
string
required
The subreddit name to search within (e.g., “fitness”, “programming”)
limit
integer
Maximum number of results to return (default: 10)

Response

success
boolean
Whether the request was successful
data
object
meta
object
Request metadata including credits_used and request_id

Example Request

curl -X GET "https://yoinkit.ai/api/v1/openclaw/reddit/subreddit/search?query=pushups&subreddit=fitness&limit=10" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Example Response

{
  "success": true,
  "data": {
    "posts": [
      {
        "id": "t3_8gmjrb",
        "post_id": "t3_8gmjrb",
        "title": "Is doing 50-100 pushups a day doing anything?",
        "url": "https://www.reddit.com/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
        "permalink": "/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
        "nsfw": false,
        "subreddit": {
          "id": "t5_2qhx4",
          "name": "Fitness",
          "nsfw": false,
          "icon": "https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png"
        },
        "votes": 1414,
        "num_comments": 582,
        "created_at_iso": "2018-05-03T01:09:17.620Z"
      }
    ],
    "comments": [
      {
        "id": "t1_nxf7p27",
        "post_id": "t3_1q2p898",
        "author": "Philser23",
        "body": "On the 30th my girlfriend decided her new year's resolution would be to start going to the gym...",
        "votes": 123,
        "url": "https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/",
        "created_at_iso": "2026-01-03T11:26:02.434Z"
      }
    ],
    "media": []
  },
  "meta": {
    "platform": "reddit",
    "endpoint": "subreddit-search",
    "credits_used": 1,
    "request_id": "req_abc123def456"
  }
}