reddit/
posts

Raccogli i post pubblici di Reddit dagli URL dei post supportati, con titoli, testo, autori, contesto della community, media, date ed engagement visibile in record normalizzati.

Reddit Posts API

Input con URL del post
Contesto della community
Istantanea dell’engagement
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 Posts

Un post di Reddit è un contenuto inviato a una community, la cui pagina pubblica può mostrare titolo, testo, autore, flair, media, data di pubblicazione e segnali visibili di voti e commenti. Collegare questi campi al subreddit e al momento dell’acquisizione rende utilizzabile il singolo post per la revisione delle fonti, l’analisi dei contenuti e il confronto nel tempo.

Funzionalità della Reddit Posts API

  • Risoluzione diretta dei postTrasforma l’URL di una discussione di Reddit accettato o un link breve redd.it in un record normalizzato di quel post pubblico, rifiutando le home dei subreddit e i percorsi non pertinenti.
  • Contenuto dei post e attribuzioneRestituisce ID del post, URL pubblico, titolo, testo e identificatori dell’autore disponibili, così ogni elemento è riconducibile alla sua fonte.
  • Contesto di subreddit e classificazioneEspone il flair insieme a nome, URL e numero visibile di iscritti della community sotto extra, quando la fonte li fornisce.
  • Media, engagement e momento dell’acquisizioneMantiene insieme in un’istantanea con data e ora i riferimenti ai media, created_at, collected_at, upvotes_count, comments_count e upvote_ratio.

Parametri della Reddit Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL di post pubblici di Reddit con percorsi /r/{subreddit}/comments/{post_id} su host Reddit supportati, oppure link brevi redd.it.

Come usare la Reddit Posts API

Invia i post pubblici esatti che ti servono, segui l’attività asincrona e leggi i record normalizzati con la paginazione a cursore.

  1. Prepara uno o più URL di post pubblici di Reddit con un percorso di commenti supportato o un link breve redd.it.
  2. Invia i link come urls a /v1/reddit/posts e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. Leggi data.results.items, poi richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.reddit.com/r/example/comments/post_id/example_post/"]}'

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

Casi d’uso della Reddit Posts API

  • Revisione dei post basata sulle fonti: Conserva ID, URL, titoli, testo e campi dell’autore dei post, così chi revisiona può riesaminare i contenuti pubblici esatti inclusi in un’analisi.
  • Confronto di argomenti tra community: Raggruppa titoli e testo per community_name e tag per esaminare come un argomento definito viene impostato nei subreddit selezionati.
  • Monitoraggio dell’engagement nel tempo: Salva upvotes_count, comments_count e upvote_ratio con collected_at per confrontare istantanee ripetute, senza considerare i valori permanenti.

Consigli degli esperti per la Reddit Posts API

  • Risolvi i link redd.it e deduplica per identificatore del post prima di creare i batch, perché un link breve e l’URL completo di una discussione possono puntare allo stesso post.
  • Usa questo endpoint quando conosci già gli URL dei post: non accetta home dei subreddit, query di ricerca, controlli di ordinamento né results_limit.
  • Considera possibile che autore, media, tag, dettagli della community, date e metriche siano null quando la fonte pubblica non li espone.
  • Salva collected_at accanto alle metriche di engagement visibili, così le istantanee successive possono essere confrontate senza sovrascrivere i rispettivi momenti di osservazione.

Oltre alla Reddit Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di Reddit.

  • 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 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 Posts API — FAQ

Reddit Posts API trasforma gli URL dei post pubblici di Reddit supportati in record normalizzati con contenuto del post, contesto di autore e subreddit, media, date e metriche di engagement visibili.

Invia un URL http o https su reddit.com, www.reddit.com, old.reddit.com o new.reddit.com il cui percorso inizi con /r/{subreddit}/comments/{post_id}. Sono accettati anche i link brevi redd.it e www.redd.it.

No. Reddit Posts API risolve gli URL specifici dei post presenti in urls; non accetta home dei subreddit, parole chiave né controlli di ordinamento per la scoperta dei post.

No. Questo endpoint accetta solo urls, perché ogni input identifica un post specifico e non un feed di post da limitare.

No. Ogni record di post può includere un comments_count visibile, ma 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 la fonte pubblica non espone un valore utilizzabile.

Ogni record di post restituito costa 0,5 crediti SocQ. Un insieme di risultati vuoto non ha alcun costo per i risultati.