reddit/
popular-feed

Raccogli i post di tendenza del feed r/popular di Reddit in uno qualsiasi dei suoi cinque ordinamenti, con titolo e testo, autore, punteggio, numero di commenti e media, fino a 500 per richiesta.

Reddit Popular Feed API

Nessun input richiesto
Cinque ordinamenti
Finestra temporale per top
Fino a 500 post
0,5 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
sort_byFacoltativoOrdinamento di r/popular: best, hot (predefinito), new, rising oppure top.
published_withinFacoltativoFinestra temporale usata quando sort_by è top: hour, day (predefinito), week, month, year oppure all.
results_limitFacoltativoNumero 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.

  1. Invia con POST {"sort_by": "hot", "results_limit": 25} a /v1/reddit/popular-feed.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

Reddit Popular Feed API — FAQ

Reddit Popular Feed API è un’interfaccia programmatica per raccogliere i post del feed r/popular di Reddit con l’ordinamento e la finestra temporale che scegli. Per ogni post restituisce titolo e testo, link, autore, punteggio, numero di commenti e media.

Tutti i campi sono facoltativi: una richiesta vuota restituisce i 25 post più hot di r/popular, mentre sort_by, published_within e results_limit regolano ordine, finestra e quantità.

results_limit accetta da 1 a 500 post per richiesta e ogni post costa 0,5 crediti, quindi i 25 post predefiniti costano 12,5 crediti e 500 post ne costano 250.