reddit/
subreddit-posts

Scopri i post pubblici di Reddit dagli URL dei subreddit ordinati per new, top o hot, con contenuto, autori, contesto della community, media ed engagement visibile come record normalizzati.

Reddit Subreddit Posts API

Input con URL del subreddit
New, top o hot
Limite per subreddit
0,5 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 Posts

I post dei subreddit sono contenuti pubblici inviati alle community, con titoli, testo, autori, flair, media, date di pubblicazione e segnali visibili di voti e commenti. Questi campi di contenuto, contesto ed engagement supportano il monitoraggio delle community, la ricerca sugli argomenti e confronti allineati tra gli elenchi dei subreddit.

Funzionalità della Reddit Subreddit Posts API

  • Scoperta degli elenchi dei subredditScopri i post pubblici dagli URL /r/{subreddit} accettati e scegli l’elenco new, top o hot per ogni subreddit della richiesta.
  • Profondità di raccolta per subredditApplica results_limit separatamente a ogni URL di subreddit inviato, con un valore predefinito di 100 e un intervallo accettato da 1 a 2.000.
  • Contenuto e autori dei post normalizzatiRestituisce identificatori dei post, URL di origine, titoli, testo, campi dell’autore disponibili e riferimenti ai media in una forma di record coerente.
  • Contesto di community ed engagementMantiene con ogni post flair, dettagli della community, date di pubblicazione e di raccolta, upvotes_count, comments_count, upvote_ratio e discovery_input.

Parametri della Reddit Subreddit Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL di subreddit pubblici di Reddit con il percorso esatto /r/{subreddit} su un host Reddit supportato.
results_limitFacoltativoNumero massimo di post richiesti per ogni URL di subreddit; il valore predefinito è 100 e accetta numeri interi da 1 a 2.000.
sort_byFacoltativoElenco applicato a ogni URL di subreddit inviato; il valore predefinito è new e supporta new, top o hot.

Come usare la Reddit Subreddit Posts API

Invia gli URL dei subreddit pubblici con una modalità di elenco e un limite di risultati per subreddit, poi leggi i risultati dell’attività asincrona con la paginazione a cursore.

  1. Prepara uno o più URL pubblici di Reddit il cui percorso sia /r/{subreddit}.
  2. Invia con POST urls, results_limit e sort_by a /v1/reddit/subreddit-posts, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. Leggi data.results.items e richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.reddit.com/r/learnpython/"],"results_limit":100,"sort_by":"new"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Reddit Subreddit Posts API

  • Monitoraggio dei post delle community: Raccogli l’elenco new e conserva ID dei post, created_at, collected_at, titoli e testo per rivedere i contenuti pubblici più recenti di subreddit selezionati.
  • Ricerca sugli argomenti dei subreddit: Raggruppa titoli, testo, flair e campi della community per esaminare argomenti e formati ricorrenti all’interno di community pubbliche definite.
  • Confronto allineato degli elenchi: Usa lo stesso sort_by su più URL di subreddit e confronta date di pubblicazione, upvotes_count, comments_count e upvote_ratio con un’unica modalità di elenco.

Consigli degli esperti per la Reddit Subreddit Posts API

  • Invia l’URL canonico della home /r/{subreddit} e non un nome di subreddit, un URL di post o un percorso più profondo, così la richiesta supera la validazione dell’URL.
  • Calcola la profondità richiesta come numero di urls moltiplicato per results_limit, perché il limite e la stima dei crediti si applicano separatamente a ogni subreddit.
  • Esegui attività separate quando confronti new, top e hot, perché un solo valore di sort_by viene applicato a ogni URL di subreddit di una richiesta.
  • Conserva discovery_input e collected_at con ogni record, così i dataset a valle mantengono il subreddit di origine e il momento dell’osservazione.
  • Considera possibile che i campi di autore, media, flair, community, data ed engagement siano null o vuoti quando un elenco pubblico non li espone.

Oltre alla Reddit Subreddit Posts 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 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 User Posts API — Raccoglie la cronologia dei post di un utente Reddit da un solo username, ordinata per new, top o hot, con titolo e testo, punteggio, commenti e media.
  • Reddit Popular Feed API — Raccoglie i post di r/popular in ordine hot, best, new, rising o top, con titolo e testo, autore, punteggio, commenti e media.

Esplora altre piattaforme

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

Reddit Subreddit Posts API — FAQ

Reddit Subreddit Posts API scopre post pubblici dagli URL di subreddit accettati, con ordinamento new, top o hot. Restituisce contenuto normalizzato, autori, contesto della community, media, date ed engagement visibile.

Invia un URL http o https su un host Reddit supportato il cui percorso sia esattamente /r/{subreddit}, con una barra finale facoltativa. Nomi di subreddit, URL di post e percorsi più profondi non sono accettati.

sort_by supporta new, top e hot e ha new come valore predefinito. La richiesta non accetta un parametro per il periodo di tempo degli elenchi top.

results_limit ha il valore predefinito 100 e accetta valori da 1 a 2.000. Si applica separatamente a ogni URL, quindi due URL con results_limit 50 richiedono fino a 100 post.

No. Ogni post può includere comments_count, ma il risultato non contiene il testo né gli autori dei commenti.

Dettagli dell’autore, media, flair, contesto della community, data di pubblicazione e valori di engagement possono essere null o vuoti quando l’elenco pubblico non espone un valore utilizzabile.

Ogni record di post restituito costa 0,5 crediti SocQ. La stima prima della richiesta usa urls moltiplicato per results_limit, e un insieme di risultati vuoto non ha alcun costo per i risultati.