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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco 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.
- Prepara uno o più URL di post pubblici di Reddit con un percorso di commenti supportato o un link breve redd.it.
- Invia i link come urls a /v1/reddit/posts e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.