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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL di subreddit pubblici di Reddit con il percorso esatto /r/{subreddit} su un host Reddit supportato. |
results_limit | Facoltativo | Numero massimo di post richiesti per ogni URL di subreddit; il valore predefinito è 100 e accetta numeri interi da 1 a 2.000. |
sort_by | Facoltativo | Elenco 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.
- Prepara uno o più URL pubblici di Reddit il cui percorso sia /r/{subreddit}.
- Invia con POST urls, results_limit e sort_by a /v1/reddit/subreddit-posts, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.