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"
  }
}