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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Query per parola chiave da eseguire all’interno della community subreddit specificata. |
urls | Obbligatorio | Array di URL Reddit pubblici /r/{subreddit} che definiscono l’ambito della community per la ricerca. |
results_limit | Facoltativo | Numero massimo di post da restituire per community; il valore predefinito è 100 e l’intervallo consentito va da 1 a 2.000. |
sort_by | Facoltativo | Modalità di ordinamento dei post trovati: relevance (predefinita), hot, top, new o comments. |
published_within | Facoltativo | Filtro 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.
- Specifica la query di ricerca e indica in urls uno o più URL di community /r/{subreddit}.
- Se vuoi, seleziona sort_by (relevance, hot, top, new, comments) e published_within (da hour a all).
- Invia una richiesta POST a /v1/reddit/subreddit-search con la tua chiave API di SocQ.
- 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.
API correlate
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.