> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit-Suche, Beiträge und Kommentare per API (REDDIT)

> Reddit-Beiträge durchsuchen, einen Beitrag mit seiner ersten Kommentarseite lesen oder die neuesten Beiträge eines Subreddits oder Nutzers auflisten.

`REDDIT` liest das öffentliche Reddit. Es hat vier Modi, die das Payload bestimmt: Suche (`query`), ein Beitrag mit seinen Kommentaren (`url`), ein Subreddit-Feed (`action: "feed"`) und die Beiträge eines Nutzers (`action: "user_posts"`).

| | |
| - | - |
| `taskType` | `REDDIT` |
| Eingabe | `query`, oder `url`, oder `action` (`feed`, `user_posts`); `subreddit`, `username`, `commentSort`, `commentMaxDepth`, `limit`, `country` |
| Credits | 1 pro Task |
| Land | Standard ist `US`. |
| Standort | Nicht unterstützt (`422 LOCATION_UNSUPPORTED`). |

## Beiträge suchen

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "REDDIT", "payload": { "query": "running shoes for flat feet", "subreddit": "RunningShoeGeeks" } }'
```

| Feld | Pflicht | Beschreibung |
| - | - | - |
| `query` | Ja | Die Suchanfrage. `prompt` wird akzeptiert, wenn `query` fehlt. |
| `subreddit` | Nein | Nur ein Subreddit durchsuchen: sein Name ohne `r/`, 2-21 Buchstaben, Ziffern oder Unterstriche. |

Die Suche liefert bis zu 25 Beiträge. Zum Beispiel:

```json theme={"theme":"css-variables"}
{
  "results": [
    { "postId": "1uzk9m4", "title": "...", "url": "https://www.reddit.com/r/RunningShoeGeeks/comments/1uzk9m4/...", "subreddit": "RunningShoeGeeks", "preview": "..." }
  ]
}
```

`preview` ist der Anfang des Beitragstexts, bis zu 2.000 Zeichen, wenn der Beitrag Text hat. Ein leeres `results` in einem abgeschlossenen Task bedeutet, dass Reddit nichts gefunden hat.

## Einen Beitrag mit Kommentaren lesen

Senden Sie statt `query` die `url` eines Beitrags:

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "REDDIT", "payload": { "url": "https://www.reddit.com/r/RunningShoeGeeks/comments/1uer62n/", "commentSort": "top", "commentMaxDepth": 1 } }'
```

| Feld | Pflicht | Beschreibung |
| - | - | - |
| `url` | Ja | Eine reddit.com-Beitragsadresse: `https://www.reddit.com/r/{subreddit}/comments/{postId}/...`. Andere Adressen liefern `422 VALIDATION_ERROR`. |
| `commentSort` | Nein | `top`, `new`, `controversial`, `old` oder `qa`. Ohne Angabe gilt Reddits eigene Standardreihenfolge. |
| `commentMaxDepth` | Nein | Entfernt Antworten, die tiefer liegen, eine Ganzzahl von 0 bis 100. `0` behält nur Kommentare der obersten Ebene. |

Der Task liest den Beitrag mit seiner ersten Kommentarseite, etwa 20-25 Kommentare. Zum Beispiel:

```json theme={"theme":"css-variables"}
{
  "post": {
    "postId": "1uer62n", "title": "...", "body": "...", "author": "...", "subreddit": "RunningShoeGeeks",
    "score": 12, "upvoteRatio": 0.9, "commentCount": 48, "createdAt": "2026-06-24T21:51:21.586000+0000",
    "archived": false, "url": "https://www.reddit.com/r/RunningShoeGeeks/comments/1uer62n/..."
  },
  "comments": {
    "availableCount": 24,
    "returnedCount": 24,
    "items": [
      { "commentId": "otlz8m5", "author": "...", "body": "...", "score": 5, "depth": 0, "isSubmitter": false, "createdAt": "...", "url": "https://www.reddit.com/r/..." }
    ]
  }
}
```

| Feld | Beschreibung |
| - | - |
| `post.commentCount` | Die Kommentarzahl des Beitrags, wie Reddit sie meldet. Lässt Reddit sie weg, die Zahl der Kommentare auf der gelesenen Seite. `comments` enthält nur diese Seite. |
| `post.archived` | Aus dem Alter des Beitrags geschätzt; Reddit sperrt Kommentare nach etwa 180 Tagen. |
| `post.author`, `post.body` | `null`, wenn Reddit nichts anzeigt (ein gelöschter Autor, ein Link-Beitrag). |
| `comments.items[].depth` | Antworttiefe; `0` ist ein Kommentar der obersten Ebene. Antworten tragen `parentId`. |
| `comments.items[].isSubmitter` | `true`, wenn der Autor des Beitrags den Kommentar geschrieben hat. |

> [!NOTE]
>
> Nur die erste Kommentarseite ist verfügbar. `commentLimit`, das weitere Kommentare aufklappt, liefert in Self-Serve-Tarifen `422 VALIDATION_ERROR`.

## Neueste Beiträge auflisten

| Payload | Liefert |
| - | - |
| `{ "action": "feed", "subreddit": "RunningShoeGeeks" }` | Die neuesten Beiträge des Subreddits. Ohne `subreddit` r/popular. |
| `{ "action": "user_posts", "username": "example_user" }` | Was der Nutzer eingereicht hat. `username` hat 3-20 Buchstaben, Ziffern, Unterstriche oder Bindestriche. |

Beide liefern `results` in der Form der Suche, bis zu `limit` Beiträge (Standard 25).

## Grenzen und Fehler

* `REDDIT` ignoriert `markdown`, `rawResponse` und `searchQueries`. Es lehnt `html` und `analysis` mit `422` und `citationAnalysis` mit `400` ab; siehe [nicht unterstützte Flags](/de/engines/response-options.md#nicht-unterstützte-flags).
* Ein ungültiges `subreddit`, `username`, `url` oder `commentSort` liefert `422 VALIDATION_ERROR`.
* Weitere Anfragefehler stehen unter [Fehler](/de/concepts/errors.md).

## Verwandt

* [Web scrape](/de/engines/web-scrape.md) für Seiten außerhalb von Reddit
* [Asynchrone Tasks](/de/concepts/async-tasks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.