All questionsReddit

How do I get Reddit data without an API key?

You do not, reliably. The old trick, appending .json to any reddit.com URL, answers with blocks and throttles for scripted traffic now. Reddit wants every automated read to identify itself with an OAuth client. Anything that avoids that runs on borrowed time and gets your IP cut off.

What you can skip is Reddit’s approval process. Openhandle reads public Reddit with a key you create yourself, no application, 100 free requests to start. Reddit endpoints are in beta.

Checked September 2026 · request and response run against the API · no affiliate links

GET /v1/reddit/subreddits/{name}/posts?sort=new
curl "https://api.openhandle.dev/v1/reddit/subreddits/synthetic/posts?sort=new" \
  -H "Authorization: Bearer $OPENHANDLE_API_KEY"
TypeScript SDK
import { OpenHandle } from '@openhandle/sdk';

const openhandle = new OpenHandle({ apiKey: process.env.OPENHANDLE_API_KEY! });
const page = await openhandle.reddit.subreddit('synthetic').posts.list({ sort: 'new' });

for (const post of page.data) console.log(post.metrics.score, post.title);
200 OK
{
  "platform": "reddit",
  "resource": "post",
  "capturedAt": "2026-09-18T12:53:48Z",
  "source": "live",
  "data": [
    {
      "id": "t3_reddit1",
      "title": "Synthetic Reddit post",
      "community": { "handle": "synthetic", "displayHandle": "r/synthetic" },
      "createdAt": "2026-08-09T15:30:00Z",
      "metrics": { "score": 0, "upvoteRatio": 0.5, "comments": 0 }
    }
  ],
  "meta": { "cursors": { "next": "b3BhcXVlLWN1cnNvcg" } }
}

Trimmed to one post. The shape matches what the .json endpoint gave you, minus the nesting. The example is a Test subreddit, so you can run it on a free Test key.

Why the .json trick stopped working

  • Reddit charges for API access now. Since 2023, Reddit meters automated reads. Unauthenticated JSON was the loophole, and Reddit closed it for anything that looks like a script.
  • User agents get fingerprinted. A custom user agent buys a few requests. A pattern of requests gets the IP throttled, then blocked.
  • Old RSS feeds too. Reddit RSS still exists for some listings, but it is rate limited the same way and returns less data.

Two honest paths

Reddit OAuth clientOpenhandle key
SetupCreate an app, get a client ID and secret, handle token refreshCreate a key in the dashboard
ApprovalFree for non-commercial. Commercial use needs a data access requestNone
LimitsAbout 100 queries per minute per client10 requests per second per key, billed per answered request
ShapeReddit’s nested listing JSONOne envelope shared with Instagram, TikTok, and X

When this does not work

These answers are definitive. Store them, do not retry them.

SituationStatusCode
The subreddit is private, quarantined, or banned403PROFILE_PRIVATE
The subreddit never existed404PROFILE_NOT_FOUND
Your key is missing or wrong401UNAUTHENTICATED
401 Unauthorized
{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "A valid Bearer key is required.",
    "requestId": "req_01j8…",
    "retryable": false
  }
}

Authentication failures are never billed. One header, one key. Test keys are free and cover every Reddit endpoint on synthetic data.

Read next

More Reddit questions

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents