reddit/
subreddit-search

Cerca discussioni e post pubblici all’interno di un subreddit specifico per query, periodo e ordinamento.

Reddit Subreddit Search API

Ricerca nella community
Scoperta mirata dei post
Discussioni dei subreddit
0,6 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Reddit Subreddit Search

Cercare all’interno di un subreddit designato isola le conversazioni rilevanti dal rumore della piattaforma più ampia. Le ricerche mirate a una community restituiscono titoli dei post normalizzati, testo, nomi degli autori, numero di commenti, upvote e link ai media.

Funzionalità della Reddit Subreddit Search API

  • Query mirata a una communityLimita le query per parola chiave a community /r/{subreddit} specifiche, invece di interrogare l’intera piattaforma.
  • Opzioni di ordinamento dettagliateOrdina i post trovati per rilevanza, hot, top, new o numero di commenti, in base alle esigenze di ricerca.
  • Filtri flessibili per periodoFiltra i risultati per periodi di pubblicazione di un’ora, un giorno, una settimana, un mese, un anno o di sempre.
  • Dettagli completi dei postRicevi record di post normalizzati con titolo, testo, autore, numero di upvote, numero di commenti e permalink.

Parametri della Reddit Subreddit Search API

ParametriObbligatorioDescrizione
queryObbligatorioQuery per parola chiave da eseguire all’interno della community subreddit specificata.
urlsObbligatorioArray di URL Reddit pubblici /r/{subreddit} che definiscono l’ambito della community per la ricerca.
results_limitFacoltativoNumero massimo di post da restituire per community; il valore predefinito è 100 e l’intervallo consentito va da 1 a 2.000.
sort_byFacoltativoModalità di ordinamento dei post trovati: relevance (predefinita), hot, top, new o comments.
published_withinFacoltativoFiltro sul periodo di pubblicazione: all (predefinito), year, month, week, day o hour.

Come usare la Reddit Subreddit Search API

Invia una query di ricerca insieme agli URL delle community di destinazione come attività asincrona, poi recupera i post trovati.

  1. Specifica la query di ricerca e indica in urls uno o più URL di community /r/{subreddit}.
  2. Se vuoi, seleziona sort_by (relevance, hot, top, new, comments) e published_within (da hour a all).
  3. Invia una richiesta POST a /v1/reddit/subreddit-search con la tua chiave API di SocQ.
  4. Interroga /v1/tasks/{task_id} e scorri data.results.items con next_cursor.
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.

Casi d’uso della Reddit Subreddit Search API

  • Monitoraggio del sentiment della community: Tieni d’occhio che cosa dicono sul tuo brand o sui concorrenti i membri di subreddit dedicati a tecnologia, finanza o videogiochi.
  • Scoperta dei problemi dei clienti: Cerca parole chiave di risoluzione dei problemi e di domande all’interno di subreddit specializzati sui prodotti per trovare i punti critici degli utenti.
  • Ricerca d’archivio su temi di nicchia: Recupera le discussioni storiche più popolari su argomenti tecnici o culturali specifici, limitate a community autorevoli.

Consigli degli esperti per la Reddit Subreddit Search API

  • Fornisci sempre URL completi /r/{subreddit} nell’array urls; il backend estrae automaticamente il nome della community.
  • Usa questo endpoint al posto di Reddit Search quando vuoi evitare il rumore tra community diverse e concentrarti su un solo subreddit.
  • Ordinare per comments aiuta a individuare i thread di dibattito con molto engagement, in cui l’opinione della community si esprime a fondo.
  • Abbinalo a Reddit Comments per ottenere l’albero completo dei commenti dei post più rilevanti trovati.

Oltre alla Reddit Subreddit Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Reddit.

  • Reddit Comments API — Raccoglie testo dei commenti pubblici, autori, riferimenti al post e al commento principale, contesto della community, date ed engagement visibile dagli URL dei post supportati.
  • Reddit Subreddit Posts API — Individua i post pubblici dagli URL dei subreddit con ordinamento per nuovi, migliori o popolari, un limite di risultati per subreddit e contesto normalizzato di community ed engagement.
  • Reddit Search API — Cerca post pubblici di Reddit per testo e intervallo di pubblicazione, restituendo contenuti, autori, contesto della community, date, media ed engagement visibile in forma normalizzata.
  • Reddit Subreddit Details API
  • Reddit Trending Searches API — Ottiene senza input le ricerche di tendenza di oggi su Reddit, ciascuna con la sua posizione e il link ai risultati di Reddit.
  • Reddit Answers API — Fai una domanda e ottieni la risposta IA di Reddit con i commenti citati, i post di origine e i subreddit consigliati.

Esplora altre piattaforme

Combina i dati di Reddit con i dati pubblici delle altre piattaforme social supportate.

Reddit Subreddit Search API — FAQ

Reddit Subreddit Search API permette la ricerca mirata per parola chiave tra i post all’interno di community Reddit specifiche. Restituisce elementi di post normalizzati, dati dell’autore, date, numero di upvote e volume di commenti.

Reddit Search cerca contemporaneamente in tutti i subreddit pubblici, mentre Reddit Subreddit Search limita la query alle community specifiche indicate nel parametro urls.

Sì. Indica più link a community nell’array urls; l’endpoint cercherà in ogni subreddit specificato e aggregherà i risultati.