Reddit Subreddit Search
Die Suche innerhalb eines bestimmten Subreddits trennt relevante Gespräche vom Rauschen der gesamten Plattform. Auf Communities begrenzte Suchen liefern normalisierte Beitragstitel, Text, Autorennamen, Kommentarzahlen, Upvotes und Medienlinks.
Funktionen der Reddit Subreddit Search API
- Auf eine Community begrenzte AbfrageBeschränken Sie Stichwortabfragen auf bestimmte /r/{subreddit}-Communities, statt die gesamte Plattform zu durchsuchen.
- Detaillierte SortieroptionenSortieren Sie gefundene Beiträge nach Relevanz, hot, top, new oder Kommentaranzahl, passend zu Ihren Recherchezielen.
- Flexible ZeitfilterFiltern Sie Ergebnisse nach Veröffentlichungszeiträumen von einer Stunde, einem Tag, einer Woche, einem Monat, einem Jahr oder der gesamten Zeit.
- Ausführliche BeitragsdetailsErhalten Sie normalisierte Beitragsdatensätze mit Titel, Text, Autor, Anzahl der Upvotes, Anzahl der Kommentare und Permalinks.
Parameter der Reddit Subreddit Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Stichwortabfrage, die innerhalb der angegebenen Subreddit-Community ausgeführt wird. |
urls | Erforderlich | Array öffentlicher Reddit-URLs der Form /r/{subreddit}, die den Community-Bereich der Suche festlegen. |
results_limit | Optional | Maximale Anzahl der zurückgegebenen Beiträge pro Community; der Standardwert ist 100, zulässig sind Werte von 1 bis 2.000. |
sort_by | Optional | Sortiermodus für gefundene Beiträge: relevance (Standard), hot, top, new oder comments. |
published_within | Optional | Filter für den Veröffentlichungszeitraum: all (Standard), year, month, week, day oder hour. |
So verwenden Sie die Reddit Subreddit Search API
Senden Sie eine Suchanfrage zusammen mit den URLs der Ziel-Communities als asynchrone Aufgabe und rufen Sie anschließend die gefundenen Beiträge ab.
- Legen Sie Ihre Suchanfrage fest und geben Sie in urls eine oder mehrere /r/{subreddit}-Community-URLs an.
- Wählen Sie optional sort_by (relevance, hot, top, new, comments) und published_within (hour bis all).
- Senden Sie eine POST-Anfrage mit Ihrem SocQ-API-Schlüssel an /v1/reddit/subreddit-search.
- Fragen Sie /v1/tasks/{task_id} ab und blättern Sie mit next_cursor durch data.results.items.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","urls":["https://www.reddit.com/r/technology/"],"results_limit":20,"sort_by":"relevance"}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.Anwendungsfälle der Reddit Subreddit Search API
- Beobachtung der Stimmung in Communities: Verfolgen Sie, was Mitglieder spezialisierter Subreddits zu Technik, Finanzen oder Gaming über Ihre Marke oder Ihre Wettbewerber sagen.
- Entdeckung von Kundenproblemen: Suchen Sie in spezialisierten Produkt-Subreddits nach Stichwörtern zu Fehlerbehebung und Fragen, um Schmerzpunkte der Nutzer zu finden.
- Archivrecherche in Nischen: Rufen Sie die besten früheren Diskussionen zu bestimmten technischen oder kulturellen Themen ab, die auf maßgebliche Communities beschränkt sind.
Profi-Tipps zur Reddit Subreddit Search API
- Geben Sie im Array urls immer vollständige /r/{subreddit}-URLs an; das Backend extrahiert den Community-Namen automatisch.
- Verwenden Sie diesen Endpunkt statt Reddit Search, wenn Sie Rauschen aus anderen Communities vermeiden und sich auf ein Subreddit konzentrieren möchten.
- Die Sortierung nach comments hilft, Threads mit starker Beteiligung zu finden, in denen die Meinung der Community ausführlich zum Ausdruck kommt.
- Kombinieren Sie den Endpunkt mit Reddit Comments, um den vollständigen Kommentarbaum der relevantesten gefundenen Beiträge abzurufen.
Verwandte APIs
Ergänzend zur Reddit Subreddit Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Reddit-Daten benötigen.
- Reddit Comments API — Öffentliche Kommentartexte, Autoren, Verweise auf Beitrag und übergeordneten Kommentar, Community-Kontext, Zeitstempel und sichtbare Interaktionen aus unterstützten Beitrags-URLs erfassen.
- Reddit Subreddit Posts API — Öffentliche Beiträge aus Subreddit-URLs mit Sortierung nach „new“, „top“ oder „hot“, einem Ergebnislimit pro Subreddit und normalisiertem Community- und Interaktionskontext ermitteln.
- Reddit Search API — Öffentliche Reddit-Beiträge per Textsuche und Veröffentlichungszeitraum suchen und normalisierte Inhalte, Autoren, Community-Kontext, Zeitstempel, Medien und sichtbare Interaktionen zurückgeben.
- Reddit Subreddit Details API
- Reddit Trending Searches API — Die heutigen Trend-Suchen auf Reddit ohne Eingabe abrufen, jeweils mit Rang und Link zu den Reddit-Ergebnissen.
- Reddit Answers API — Eine Frage stellen und die KI-Antwort von Reddit mit zitierten Kommentaren, Quellbeiträgen und empfohlenen Subreddits erhalten.