Reddit Popular Feed
Il feed popolare di Reddit, r/popular, è il flusso dei post che stanno salendo contemporaneamente in tutte le community del sito, ognuno con titolo e testo, autore, punteggio, numero di commenti, data di pubblicazione e immagini o video allegati. Letto con ordinamenti e finestre temporali diverse, mostra quali notizie, formati e argomenti si stanno imponendo su tutta la piattaforma, e supporta l’individuazione precoce delle notizie, la ricerca sui formati dei contenuti e il campionamento di ciò di cui si parla su Reddit.
Funzionalità della Reddit Popular Feed API
- Cinque modi di ordinare r/popularsort_by legge il feed come best, hot, new, rising o top, e se il campo manca viene usato hot.
- Finestra temporale per l’ordinamento toppublished_within limita top all’ultima ora, giorno, settimana, mese o anno, oppure a tutto il periodo, con day come valore predefinito.
- Post completi con autore e mediaOgni riga contiene text con titolo e corpo, l’url del post, username e link al profilo dell’autore, il punteggio in likes_count, comments_count e media con le dimensioni in pixel.
Parametri della Reddit Popular Feed API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
sort_by | Facoltativo | Ordinamento di r/popular: best, hot (predefinito), new, rising oppure top. |
published_within | Facoltativo | Finestra temporale usata quando sort_by è top: hour, day (predefinito), week, month, year oppure all. |
results_limit | Facoltativo | Numero massimo di post da raccogliere, un intero da 1 a 500; il valore predefinito è 25. |
Come usare la Reddit Popular Feed API
Scegli un ordinamento e un limite, oppure invia un corpo vuoto, poi scorri le pagine del feed.
- Invia con POST {"sort_by": "hot", "results_limit": 25} a /v1/reddit/popular-feed.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi i post da results.items e carica le pagine successive con results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sort_by":"hot","results_limit":25}'Casi d’uso della Reddit Popular Feed API
- Intercettare le notizie prima del picco: Interroga periodicamente sort_by rising o new e osserva published_at, likes_count e comments_count per vedere quali post stanno accelerando su r/popular.
- Riepilogo settimanale dei post più votati: Richiedi sort_by top con published_within week ed elenca url, text e punteggio di ciò che ha sfondato negli ultimi sette giorni.
- Capire quali formati arrivano su r/popular: Raggruppa i post per tipo di media in immagine, video e solo testo, poi confronta likes_count e comments_count tra i gruppi.
Consigli degli esperti per la Reddit Popular Feed API
- Imposta sort_by su top ogni volta che usi published_within, perché la finestra temporale vale solo per l’ordinamento top.
- Registra collected_at con ogni istantanea ed elimina i duplicati su id, perché lo stesso post può comparire in raccolte consecutive di un feed che cambia in fretta.
- Invia author.username a Reddit User Profile API quando un autore continua a comparire, per controllarne karma ed età dell’account.
API correlate
Oltre alla Reddit Popular Feed 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 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 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 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.