M
MesmerTools
GET/v1/reddit/search

Reddit search API

Global Reddit post search — not scoped to a sub, 7 results per page. Returns the raw t3_* fields Reddit's search page carries (id, name, title, author, subreddit, permalink, score/ups, num_comments, created_utc, over_18, spoiler, thumbnail) plus `created_at_iso`. Search results carry no body text, outbound URL or flair — fetch /v1/reddit/post/comments for a post's full detail. Useful for keyword monitoring, brand tracking, and topical research.

Authentication

Include x-api-key: <your_key> in your request headers
Requests without a valid key get a 401 Unauthorized. Revoked keys return 403 Forbidden.
Get a key

Parameters

queryRequired
string
Search string.
sortOptional
enumdefault: relevance
Result ordering.
relevancenewtopcomment_count
timeframeOptional
enumdefault: all
Time window for top/comment_count.
allhourdayweekmonthyear
afterOptional
string
Pagination cursor — pass the previous response's "after" (opaque).
trimOptional
boolean
Accepted for compatibility; search results carry no selftext_html.

Example request

curl "https://mesmer.tools/api/v1/reddit/search?query=openai&sort=relevance" \
  -H "x-api-key: <YOUR_API_KEY>"

Try it now

Hits the live endpoint with your API key.

Saved locally in your browser. Mint a key in /admin/api-keys.

Response schema

Trimmed example — see Field reference for descriptions.

{
  "success": true,
  "credits_remaining": -1,
  "posts": [
    {
      "id": "1szx9k2",
      "name": "t3_1szx9k2",
      "title": "OpenAI announces o4-mini …",
      "subreddit": "OpenAI",
      "author": "samaltman",
      "permalink": "/r/OpenAI/comments/1szx9k2/openai_announces_o4mini/",
      "score": 5810,
      "ups": 5810,
      "num_comments": 412,
      "created_utc": 1777501902,
      "created_at_iso": "2026-04-25T08:45:02.000Z"
    },
    "...6 more posts"
  ],
  "after": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoi..."
}

Field reference

Each posts[] entry — the fields you'll most likely use.

id
string
Base-36 Reddit post id (`name` is the t3_* fullname).
title
string
Post title as posted by the OP.
subreddit
string
Subreddit name without the r/ prefix.
author
string
Username of the OP.
permalink
string
Relative path on reddit.com (prepend https://www.reddit.com).
score
number
Net votes (same value as ups).
num_comments
number
Comment count at fetch time.
created_utc
number
Post creation time, Unix epoch seconds.
over_18
boolean
NSFW flag.
thumbnail
string
Thumbnail URL, or null.
created_at_iso
string
ISO-8601 string equivalent of created_utc. Added by this API.
Previous
Subreddit details
/v1/reddit/subreddit/details
Next
Post comments
/v1/reddit/post/comments