Torna alle API
Dati pubblici di Reddit

Reddit Public Data API

Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.

API di Reddit disponibili

Usa Posts per un singolo post noto, Comments per le sue risposte pubbliche, Subreddit Posts per il feed di una community o Search per scoprire contenuti con le parole chiave.

Quali dati di Reddit puoi recuperare?

SocQ restituisce contenuti pubblici di Reddit normalizzati, con contesto su community, risposte, scoperta, engagement e momento della raccolta, per l’analisi delle discussioni.

Post ed engagement visibile

Recupera titoli, testo, autori, flair, contesto della community, media, URL di origine e metriche visibili riferite a collected_at.

Commenti e relazioni tra risposte

Recupera testo dei commenti pubblici, autori, riferimenti al post di origine e al commento padre, date, upvote e numero di risposte.

Scoperta dei subreddit

Sfoglia i post new, top o hot dagli URL /r/{subreddit} con un limite di risultati separato per ogni community.

Ricerca per parola chiave

Cerca i post pubblici per query di testo e periodo di pubblicazione, mantenendo insieme il post trovato e il contesto di scoperta.

SocQ vs Reddit Data API

SocQ offre flussi di lavoro per la raccolta di dati pubblici di Reddit. La Data API di Reddit è l’interfaccia ufficiale per le app approvate che accedono ai dati di Reddit o li modificano.

FunzionalitàSocQReddit Data API
Uso principaleRaccogliere post pubblici, commenti, elenchi di subreddit e risultati di ricercaCreare app, integrazioni e strumenti di moderazione approvati per Reddit
AutenticazioneChiave API di SocQ; nessun OAuth utente di RedditApprovazione di Reddit, credenziali OAuth e un’identità dell’app dichiarata
Input inizialeURL pubblico di un post o di un subreddit, oppure una query di testoEndpoint di Reddit, fullname, parametri degli elenchi e scope OAuth
Pubblicare, votare o moderareNon supportatoSupportato per i casi d’uso approvati con gli scope utente richiesti
Formato della rispostaRecord normalizzati di SocQOggetti ed elenchi nativi di Reddit

Come funziona l’API di Reddit

La raccolta diretta, la navigazione dei subreddit e la ricerca per parola chiave usano lo stesso flusso di lavoro con attività asincrona e risultati paginati.

  1. 1. Invia il tuo input

    Invia URL di post, URL di subreddit o una query di ricerca all’API corrispondente e salva il task_id restituito.

  2. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’elaborazione non è completata.

  3. 3. Recupera i risultati

    Leggi data.results.items e usa next_cursor finché has_more è true.

Cerca discussioni pubbliche su Reddit

Autenticati con la tua chiave API di SocQ e invia una parola chiave con un periodo di pubblicazione. Le altre API di Reddit usano lo stesso flusso di attività.

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 comuni dell’API di Reddit

Monitoraggio delle community

Raccogli i post new, top o hot di subreddit selezionati e confronta l’attività visibile tra le community.

Analisi di discussioni e risposte

Studia contenuto dei post, testo dei commenti, relazioni tra risposte, autori ed engagement al momento della raccolta all’interno di discussioni selezionate.

Ricerca su argomenti e mercato

Cerca parole chiave e periodi definiti per trovare discussioni pubbliche su prodotti, brand, concorrenti o tendenze.

Archivi e dataset di ricerca

Conserva post e commenti pubblici, link alla fonte, contesto della community, date e metriche visibili per analisi ripetibili.

Limiti e policy sui dati pubblici

I risultati di Reddit sono record pubblici riferiti a un preciso momento. Queste API non accedono a community private, contenuti eliminati, dati degli account o controlli di moderazione.

  • Posts e Comments accettano URL di post supportati o link redd.it. Subreddit Posts richiede un percorso /r/{subreddit} esatto.
  • Subreddit Posts supporta l’ordinamento new, top o hot, con results_limit applicato separatamente a ogni URL di subreddit.
  • Search accetta una sola query, un results_limit da 1 a 2.000 e un periodo di pubblicazione tra hour, day, week, month, year o all. Non espone filtri per subreddit o ordinamento.
  • Posts e Comments restano risorse separate; un post include comments_count ma non i singoli record dei commenti.
  • Comments restituisce i commenti pubblici visibili ma non garantisce l’albero completo delle risposte né l’intera profondità storica della discussione.
  • Le metriche visibili sono istantanee riferite a collected_at. I campi facoltativi possono essere null o vuoti se la fonte pubblica non li espone.

Domande frequenti sull’API di Reddit

Che cos’è l’API di Reddit?

L’API di Reddit è un insieme di endpoint di SocQ per recuperare post e commenti pubblici noti, sfogliare i post dei subreddit e cercare discussioni pubbliche per parola chiave e periodo di pubblicazione.

Quali link di Reddit sono accettati?

Posts e Comments accettano percorsi /r/{subreddit}/comments/{post_id} supportati o link redd.it. Subreddit Posts accetta un percorso /r/{subreddit} esatto.

Quale API di Reddit devo scegliere?

Usa Posts per un post noto, Comments per le sue risposte pubbliche, Subreddit Posts per l’elenco di una community e Search per scoprire contenuti con le parole chiave.

In cosa differiscono la navigazione dei subreddit e la ricerca su Reddit?

Subreddit Posts sfoglia i post new, top o hot dagli URL /r/{subreddit} esatti. Search trova post pubblici a partire da una query di testo e da un periodo di pubblicazione.

I commenti e le metriche di engagement di Reddit sono completi o in tempo reale?

No. Comments riflette le risposte pubbliche visibili restituite al momento della raccolta, e i valori di engagement sono istantanee riferite a un preciso momento, non la cronologia completa né feed in tempo reale.

Quanto costa la raccolta di dati da Reddit?

Ogni risultato di Posts o Subreddit Posts costa 0,5 crediti, ogni commento costa 0,3 crediti e ogni risultato di Search costa 0,6 crediti; un insieme di risultati vuoto non ha alcun costo per i risultati.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.