M
MesmerTools
GET/v1/reddit/search

Reddit search API

Global Reddit post search — not scoped to a sub. Returns Reddit's raw t3_* post shape with an additional `created_at_iso` field so you don't have to convert epoch seconds yourself. 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".
trimOptional
boolean
Set to "true" to omit 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",
      "title": "OpenAI announces o4-mini …",
      "subreddit": "OpenAI",
      "author": "samaltman",
      "url": "https://www.reddit.com/r/OpenAI/comments/1szx9k2/...",
      "ups": 5810,
      "num_comments": 412,
      "created_utc": 1777501902,
      "created_at_iso": "2026-04-25T08:45:02.000Z"
    },
    "...24 more posts"
  ],
  "after": "t3_1szp1bn"
}

Field reference

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

id
string
Base-36 Reddit post id (e.g. "1t8r5sf"). Pair with subreddit to rebuild a URL.
title
string
Post title as posted by the OP.
subreddit
string
Subreddit name without the r/ prefix.
author
string
Username of the OP, or [deleted] if removed.
url
string
Outbound link (for link posts) or full Reddit URL (for self posts).
permalink
string
Relative path on reddit.com (prepend https://www.reddit.com).
selftext
string
Body text in Markdown. Empty string for link posts.
ups
number
Upvote count (already net of downs on modern Reddit).
num_comments
number
Comment count at fetch time.
created_utc
number
Post creation time as a Unix epoch seconds float.
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