Get started for $0
All APIs

Reddit API

Available

Read public Reddit data through 20 typed endpoints with shared authentication, caching, and usage tracking.

Get your API keyRead the Reddit docs

$2.50 per 1,000 requests. Your first 100 are free, no card needed.

GET /v1/reddit/profiles/{identifier}
curl "https://api.openhandle.dev/v1/reddit/profiles/@synthetic_reddit" \
  -H "Authorization: Bearer $OPENHANDLE_TEST_KEY"
200 OK
{
  "platform": "reddit",
  "resource": "profile",
  "capturedAt": "2026-09-29T14:06:45.370908Z",
  "source": "live",
  "data": {
    "id": "t2_syn0001",
    "handle": "synthetic_reddit",
    "displayHandle": "u/synthetic_reddit",
    "displayName": "Synthetic Reddit",
    "bio": "A fictional public Reddit profile for deterministic API testing. Contact: synthetic [at] example.openhandle.dev",
    "extracted": {
      "emails": [
        "synthetic@example.openhandle.dev"
      ],
      "phones": [],
      "links": [],
      "handles": []
    },
    "url": "https://www.reddit.com/user/synthetic_reddit/",
    "createdAt": "2014-03-02T09:15:00Z",
    "avatar": {
      "type": "image",
      "url": "https://media.openhandle.dev/A8ZACU8xNhW5s4J-iEFU3nifMlYd2G8EC-48QwsSy-EhRPdIaV_PCqKKblTwL9mw3v6IK64-nhqXae3ug0h7yWliJKFEnhQ-S7vpc3wgXpf-v3TEvkNovDr8etTUEYqhQnhldt98svNkn2vygPc",
      "label": null,
      "width": null,
      "height": null,
      "variants": null
    },
    "snoovatar": null,
    "banner": {
      "type": "image",
      "url": "https://media.openhandle.dev/A7hkCK5iuQ4BVQfYHdJlSlS1FAjXZBNM_bGVGUUaySK6DCmdt5LlzEVuRMkOWkuZnfewncp2F6TlySzr5epaSlhXn4sMaZurqCuCdasjBQt-YniTcYwTcqkS-gORvITfTfJELcUOklJ78nCm9C8",
      "label": null,
      "width": null,
      "height": null,
      "variants": null
    },
    "isPremium": false,
    "isEmployee": false,
    "isModerator": true,
    "acceptsFollowers": true,
    "isSensitive": false,
    "verification": {
      "reportedVerified": true,
      "hasVerifiedEmail": true
    },
    "visibility": {
      "hideFromRobots": false
    },
    "metrics": {
      "followers": 1280,
      "karma": {
        "posts": 4200,
        "comments": 18650,
        "awardee": 120,
        "awarder": 35,
        "total": 23005
      }
    },
    "profileCommunity": {
      "handle": "u_synthetic_reddit",
      "type": "user",
      "displayHandle": null,
      "icon": null,
      "communityIcon": null,
      "primaryColor": null
    }
  }
}

The real answer to this request with a free Test key. Test keys read a synthetic dataset, so your first call returns the same answer. Only the capture time and the signed media links differ.

Endpoints

Everything public on Reddit, 20 operations.

Profiles, posts, comments, and more, grouped by what they read. Each one is one call.

Profiles

5 operations
  • Get a profileGET /v1/reddit/profiles/{identifier}
  • List profile postsGET /v1/reddit/profiles/{identifier}/posts
  • List profile commentsGET /v1/reddit/profiles/{identifier}/comments
  • List moderated subredditsGET /v1/reddit/profiles/{identifier}/moderated
  • List profile trophiesGET /v1/reddit/profiles/{identifier}/trophies

Posts

3 operations
  • Get a postGET /v1/reddit/posts/{identifier}
  • List post commentsGET /v1/reddit/posts/{identifier}/comments
  • List duplicate postsGET /v1/reddit/posts/{identifier}/duplicates

Trending

1 operation
  • List trending postsGET /v1/reddit/trending/posts

Search

3 operations
  • Search postsGET /v1/reddit/search/posts?q={query}
  • Search profilesGET /v1/reddit/search/profiles?q={query}
  • Search subredditsGET /v1/reddit/search/subreddits?q={query}

Domains

1 operation
  • List domain postsGET /v1/reddit/domains/{identifier}/posts

Subreddits

7 operations
  • Get a subredditGET /v1/reddit/subreddits/{identifier}
  • List subreddit postsGET /v1/reddit/subreddits/{identifier}/posts
  • List subreddit rulesGET /v1/reddit/subreddits/{identifier}/rules
  • List wiki pagesGET /v1/reddit/subreddits/{identifier}/wiki-pages
  • Get a wiki pageGET /v1/reddit/subreddits/{identifier}/wiki-pages/{page}
  • List popular subredditsGET /v1/reddit/subreddits/popular
  • List new subredditsGET /v1/reddit/subreddits/new

Post comments return a nested tree. Use depth to control reply levels.

Popular Reddit data

Reddit comments APIReddit posts API
Built for
  • Community research
  • Brand monitoring
  • Content discovery
Known boundaries
  • Public content only.
  • Profile ID lookups work only for profiles fetched by username before.
  • Comment trees support a maximum depth of 10 and do not expose a continuation cursor.

FAQ

Reddit questions.

Can I test without calling Reddit?
Yes. Test keys use deterministic synthetic responses.
Does karma mean followers?
No. Responses keep karma, subscriber counts, and scores separate.

Let your agent wire up Reddit.

Copy one prompt. It has the docs, the spec, and an example request. Your agent reads it and builds against your test key.

Send your agent ahead.

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

For agents
Get started for $0Read the quickstart

100 free requests. No card needed.