reddit/
search

Cerca i post pubblici di Reddit per query e periodo di pubblicazione, con titoli, testo, autori, contesto della community, date, media ed engagement visibile normalizzati.

Reddit Search API

Ricerca di post
Periodo di pubblicazione
Contesto di scoperta
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 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

ParametriObbligatorioDescrizione
queryObbligatorioTesto obbligatorio e non vuoto usato per scoprire i post pubblici di Reddit.
results_limitFacoltativoNumero massimo di post da richiedere. Il valore predefinito è 100 e accetta numeri interi da 1 a 2.000.
published_withinFacoltativoPeriodo 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.

  1. Prepara una sola query di testo non vuota e scegli facoltativamente una finestra published_within e un results_limit.
  2. Invia con POST i parametri a /v1/reddit/search e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

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

Reddit Search API — FAQ

Reddit Search API scopre post pubblici a partire da una query di testo non vuota, con un periodo di pubblicazione e un tetto ai risultati facoltativi. Restituisce contenuto dei post, autori, contesto dei subreddit, media, date, engagement visibile e input di scoperta.

La richiesta accetta query, results_limit e published_within. query è obbligatoria; l’endpoint non espone controlli per URL dei subreddit, tipo di contenuto od ordinamento.

Ogni post normalizzato può includere ID, URL, titolo, testo, autore, contesto della community, media, date di pubblicazione e di raccolta, upvote e commenti visibili, rapporto degli upvote e input di scoperta.

published_within accetta hour, day, week, month, year o all. Il valore predefinito è all.

results_limit ha il valore predefinito 100 e accetta numeri interi da 1 a 2.000 come massimo richiesto. Dopo il successo dell’attività, continua con next_cursor finché has_more è true per leggere tutte le pagine di risultati archiviate.

Ogni risultato di ricerca normalizzato restituito costa 0,6 crediti SocQ. Un insieme di risultati vuoto non ha alcun costo per i risultati.