Reddit Search
I risultati di Reddit Search sono post pubblici associati a una query di testo, con titoli, testo, autori, contesto dei subreddit, media, date di pubblicazione e segnali visibili di voti e commenti. Questi record supportano la scoperta di argomenti, la revisione delle fonti, la ricerca per periodo e il confronto dell’engagement tra query definite.
Funzionalità della Reddit Search API
- Scoperta di post guidata da una queryUsa una sola query di testo non vuota per scoprire i post pubblici di Reddit, senza fornire URL di post o di subreddit.
- Filtro per periodo di pubblicazioneLimita la scoperta all’ultima ora, all’ultimo giorno, all’ultima settimana, all’ultimo mese o all’ultimo anno, oppure usa all per l’intero intervallo di tempo supportato.
- Richieste con risultati limitatiImposta results_limit da 1 a 2.000 per controllare il numero massimo di post richiesti per la query.
- Post normalizzati e contesto di scopertaRestituisce in un record coerente contenuto del post, campi di autore e community, media, date, engagement visibile e input di scoperta.
Parametri della Reddit Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Testo obbligatorio e non vuoto usato per scoprire i post pubblici di Reddit. |
results_limit | Facoltativo | Numero massimo di post da richiedere. Il valore predefinito è 100 e accetta numeri interi da 1 a 2.000. |
published_within | Facoltativo | Periodo di pubblicazione dei post trovati. Il valore predefinito è all e supporta hour, day, week, month, year o all. |
Come usare la Reddit Search API
Invia una query mirata con il periodo desiderato e il tetto dei risultati, poi leggi i record normalizzati dei post dall’attività asincrona completata.
- Prepara una sola query di testo non vuota e scegli facoltativamente una finestra published_within e un results_limit.
- Invia con POST i parametri a /v1/reddit/search e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi data.results.items, poi richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"machine learning","results_limit":100,"published_within":"month"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Reddit Search API
- Scoperta di discussioni su un argomento: Usa titoli dei post, testo, nomi delle community e URL di origine per trovare discussioni pubbliche su un tema definito.
- Dataset di ricerca riconducibili alla fonte: Conserva ID dei post, URL, autori, date di pubblicazione e discovery_input, così ogni record raccolto resta collegato alla sua fonte e alla sua query.
- Confronto dell’engagement per periodo: Combina published_within con created_at, collected_at, upvotes_count, comments_count e upvote_ratio per confrontare campioni di risultati limitati.
Consigli degli esperti per la Reddit Search API
- Usa una query mirata che rappresenti una sola domanda di ricerca, così il testo dei post trovati e il contesto della community restano interpretabili.
- Scegli published_within per il periodo che ti serve; lascialo su all quando un limite di pubblicazione escluderebbe post più vecchi rilevanti.
- Considera results_limit un tetto della richiesta, poi prosegui con i cursori dei risultati dell’attività finché has_more è false per leggere tutti i risultati archiviati.
- Deduplica le ricerche ripetute per ID del post, conservando extra.discovery_input e collected_at per il contesto della query e dell’osservazione.
- Tratta i campi di autore, media, community, data ed engagement come nullable, perché la fonte pubblica può omettere singoli valori.
API correlate
Oltre alla Reddit Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Reddit.
- Reddit Posts API — Raccoglie testo dei post pubblici, autori, contesto della community, media, date ed engagement visibile dagli URL Reddit supportati.
- 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 Subreddit Search 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.