Reddit posts data API

What you can request

Set mode in the request body to choose what comes back; without it the request runs as posts. Each mode reads the inputs listed next to it.

Every request also takes maxItems (records for the whole request) and maxItemsPerInput (records per search, URL or name).

Datasets

These Reddit record types have their own page, with their own example record, fields, options and prices.

Example request and record

The request below is the one this example record answers. The names, usernames, photos and contact details of people in it are fictional. Long values in the record are shortened.

curl -X POST https://api.urakimon.com/records/reddit \
  -H "x-api-key: $URAKIMON_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "mode": "posts",
    "subreddits": ["Python"],
    "sort": "hot",
    "maxItemsPerInput": 30
  }'

import os
import requests

res = requests.post(
    "https://api.urakimon.com/records/reddit",
    headers={"x-api-key": os.environ["URAKIMON_API_KEY"]},
    json={
        "mode": "posts",
        "subreddits": [
            "Python"
        ],
        "sort": "hot",
        "maxItemsPerInput": 30
    },
)
res.raise_for_status()
records = res.json()["records"]

const res = await fetch("https://api.urakimon.com/records/reddit", {
  method: "POST",
  headers: {
    "x-api-key": process.env.URAKIMON_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "mode": "posts",
    "subreddits": ["Python"],
    "sort": "hot",
    "maxItemsPerInput": 30
  }),
});
const { records } = await res.json();

{  "source": "reddit",  "id": "t3_1wkziub",  "postId": "1wkziub",  "title": "State of the art in Python 2026?",  "url": "https://www.reddit.com/r/Python/comments/1wkziub/state_of_the_art_in_python_2026/",  "permalink": "/r/Python/comments/1wkziub/state_of_the_art_in_python_2026/",  "contentUrl": "https://www.reddit.com/r/Python/comments/1wkziub/state_of_the_art_in_python_2026/",  "domain": "self.Python",  "postType": "text",  "subreddit": "Python",  "subredditPrefixed": "r/Python",  "subredditId": "t5_2qh0y",  "author": "example_user_1",  "authorId": "t2_example1",  "score": 427,  "upvoteRatio": 0.9383983572895277,  "commentCount": 167,  "awardCount": 0,  "createdAt": "2026-09-19T22:26:17.014000+0000",  "language": "en",  "isNsfw": false,  "isSpoiler": false,  "isPromoted": false,  "isStickied": false,  "moderationVerdict": null,  "thumbnail": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_4.png",  "authorFlair": null,  "flair": "Discussion",  "text": "What would you guys consider the state of the art in python in 2026, or what do you expect from modern python codebases?\n\nHeres my list, …",  "bodyHtml": "<p>\n      What would you guys consider the state of the art in python in 2026, or what do you expect from modern python codebases?\n    </…",  "mediaType": "text",  "media": [],  "isSelf": true,  "isGallery": false,  "hasMedia": false,  "wordCount": 157,  "type": "post",  "event": "post",  "collectedAt": "2026-09-20T19:44:36.052Z"}

Fields

Every record starts with the same envelope: source, type, event, id, url, collectedAt. What the envelope means. The tables below list the fields after it, read from real Reddit records. Where a field does not apply to an item it is null or an empty list, not left out. "Present on" names the billed events a field comes with when it is not on every record of that type.

post records

One record describes a single Reddit post, from a subreddit listing or from a search hit. Billed as post or search-result.

comment records

One record describes a single Reddit comment, from a post's comment thread or from a search hit. Billed as comment or search-result. 26 fields. Reddit comments: every field, an example record and the options

community records

One record describes a single subreddit (community), from its own page or from a search hit. Billed as search-result.

Reddit data pricing

You pay once for each record you receive, at the price of the event it carries. A request that returns nothing costs nothing.

All pricesHow billing works

Freshness and limits

• Records are collected when you send the request. Each one carries collectedAt, the UTC time it was read.
• POST /records/reddit returns up to 500 records in one response. Ask for more and it answers 413; send the same body to POST /jobs/reddit instead.
• A request without maxItems returns up to 100 records.
• Your key's rate limit and quotas apply to every source.

Next steps

• Make your first request
• Choose between records and jobs
• Rate limits and quotas
• Get a signed webhook when a job finishes