RedditUtenti RedditRegole dei subredditTendenzeGuida alle API

API utenti Reddit: profili, cronologia di post e commenti, tendenze e regole

Sette nuovi endpoint SocQ per Reddit: profili utente, cronologia di post e commenti, subreddit attivi, r/popular, ricerche di tendenza e regole dei subreddit, con richieste e prezzi per risultato.

SocQAggiornato il 19 novembre 20268 min di lettura

SocQ copriva già post, commenti, elenchi di subreddit e ricerca su Reddit. Il 2026-11-17 ha aggiunto sette endpoint che rispondono a domande diverse: chi è questo utente Reddit, cosa pubblica e cosa dice, e dove è attivo, oltre a cosa è di tendenza su Reddit e cosa consente ogni subreddit.

Questa guida spiega cosa restituisce ogni nuovo endpoint, la richiesta, il prezzo e quando usarlo. Per l’API ufficiale di Reddit, OAuth e gli endpoint lanciati in precedenza, leggi la guida alle API di Reddit e il confronto tra API di scraper per Reddit.

Risposta rapida: invia un nome utente, l’URL di un subreddit o nessun input a uno dei sette endpoint POST /v1/reddit/... con Authorization: Bearer $SOCQ_API_KEY. Interroga GET /v1/tasks/{task_id} finché status non è succeeded, poi leggi data.results.items. Cinque endpoint sono addebitati per risultato (0.3 o 0.5 crediti); Active Subreddits e Trending Searches costano 0.5 crediti per chiamata. Un credito vale $0.005.

I sette nuovi endpoint Reddit

EndpointCosa restituiscePrezzo
User ProfileKarma (post e commenti), numero di post e commenti, età dell’account, descrizione, avatar, trofei, flag di account verificato e dipendente0.5 crediti ($0.0025) per account
User PostsI post di un utente ordinati per nuovi, top o hot, con testo completo, punteggio, commenti e media0.5 crediti ($0.0025) per post
User CommentsI commenti di un utente con punteggio, ora, link e il post su cui è stato lasciato ciascuno0.3 crediti ($0.0015) per commento
User Active SubredditsI subreddit in cui l’utente è attivo, con numero di membri e descrizioni0.5 crediti ($0.0025) per chiamata
Popular FeedPost su r/popular ordinati per best, hot, new, top o rising0.5 crediti ($0.0025) per post
Trending SearchesLe ricerche di tendenza di oggi su Reddit, in classifica0.5 crediti ($0.0025) per chiamata
Subreddit RulesRegole numerate con titolo breve e testo completo0.5 crediti ($0.0025) per subreddit

Analizza un utente Reddit

Reddit User Profile

La Reddit User Profile API restituisce una riga per account: karma totale diviso tra karma dei post e dei commenti, quanti post e commenti ha pubblicato l’account, quando è stato creato, descrizione del profilo e avatar, numero di trofei e flag per account verificati e dipendenti di Reddit. Usala per valutare un creator prima di contattarlo o per capire quanto sono affermati gli autori di un thread.

curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["spez", "GovSchwarzenegger"]
  }'

Invia fino a 100 nomi utente, con o senza il prefisso u/. Consulta la documentazione di User Profile.

Reddit User Posts

La Reddit User Posts API recupera la cronologia dei post di un utente con il testo completo dei self post, link del post, punteggio, numero di commenti, ora di pubblicazione ed eventuali immagini o video. Ordina per new per seguire ciò che una persona condivide adesso, o per top per vedere quali post hanno avuto più successo.

curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "spez",
    "sort_by": "new",
    "results_limit": 25
  }'

sort_by può essere new (predefinito), top o hot. results_limit vale 25 per impostazione predefinita e accetta valori da 1 a 1.000. likes_count contiene il punteggio del post. Consulta la documentazione di User Posts.

Reddit User Comments

La cronologia dei commenti mostra cosa una persona sa e cosa le sta a cuore meglio dei suoi stessi post. La Reddit User Comments API restituisce ogni commento con punteggio, ora, link al commento e il post_id del post su cui è stato lasciato. Usala per qualificare esperti e potenziali clienti, o per monitorare come un account parla del tuo prodotto.

curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "spez",
    "sort_by": "top",
    "results_limit": 100
  }'

results_limit vale 100 per impostazione predefinita e accetta valori da 1 a 1.000. text contiene un’anteprima di massimo 300 caratteri; url apre il commento completo. Consulta la documentazione di User Comments.

Reddit User Active Subreddits

La Reddit User Active Subreddits API elenca le community in cui un utente ha pubblicato o commentato di recente, ciascuna con numero di membri e descrizione. Ti permette di mappare gli interessi di una persona e ti indica le community di nicchia frequentate dal tuo pubblico.

curl -X POST "https://api.socq.ai/v1/reddit/user-active-subreddits" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "GovSchwarzenegger"
  }'

Una richiesta costa 0.5 crediti e restituisce tutte le community presenti nell’elenco pubblico delle attività dell’account. Consulta la documentazione di Active Subreddits.

Segui cosa è di tendenza su Reddit

La Reddit Popular Feed API legge r/popular così come lo mostra Reddit: i post in crescita in tutte le community, con titolo e corpo, link, autore, punteggio, numero di commenti e media. Imposta sort_by su top e definisci published_within per vedere cosa ha sfondato nell’arco di un giorno o di una settimana.

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
  }'

Tutti i campi sono facoltativi. sort_by può essere best, hot (predefinito), new, top o rising; published_within si applica a top e va da hour ad all. results_limit vale 25 per impostazione predefinita e accetta valori da 1 a 500. Consulta la documentazione di Popular Feed.

La Reddit Trending Searches API restituisce le ricerche di tendenza di oggi nell’ordine in cui Reddit le elenca: spesso notizie, lanci di prodotto e momenti culturali mentre accadono. Interrogala qualche volta al giorno per una dashboard delle tendenze, poi approfondisci un argomento con Reddit Search.

curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Non serve alcun input. Ogni chiamata restituisce l’elenco attuale, di solito sei ricerche, in classifica a partire da 1. Consulta la documentazione di Trending Searches.

Controlla le regole di un subreddit prima di pubblicare

La Reddit Subreddit Rules API restituisce una riga per subreddit con le sue regole numerate in ordine, ciascuna con il titolo breve che i moderatori mostrano nel menu di segnalazione e il testo completo della regola. I brand la usano per verificare cosa è consentito prima di un post di lancio; i team che gestiscono molti account tengono un regolamento per ogni community.

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.reddit.com/r/AskReddit/"]
  }'

Consulta la documentazione di Subreddit Rules.

Autenticazione e flusso asincrono dei task

Ogni richiesta include la tua chiave API e un content type JSON:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Ogni chiamata di invio avvia un task in background (submit -> task_id -> queued -> running -> succeeded, oppure failed). La risposta all’invio restituisce data.task_id e data.status. Interroga il task:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Finché il task è queued, running o failed, la risposta contiene solo i metadati del task; in caso di failed, leggi error_message. Quando è succeeded, la risposta include la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500. Se has_more è true, passa results.next_cursor come cursor. fields accetta fino a 50 campi o percorsi puntati separati da virgole.

Un timeout lato client non annulla il task; riprendi con lo stesso task_id invece di pagare un duplicato. Puoi anche aggiungere callback_url al corpo dell’invio per ricevere una POST con il riepilogo del task quando termina.

Quanto costa un lavoro tipico

  • Profilare 100 autori di un thread: 100 × 0.5 = 50 crediti, $0.25.
  • Analisi completa di un utente (25 post, 100 commenti, subreddit attivi): 12.5 + 30 + 0.5 = 43 crediti, $0.215.
  • Ricerche di tendenza quattro volte al giorno per 30 giorni: 120 × 0.5 = 60 crediti, $0.30.

FAQ

Posso cercare molti utenti Reddit in una volta?

User Profile accetta fino a 100 nomi utente per richiesta. User Posts, User Comments e Active Subreddits accettano un solo username ciascuno, quindi invia un task per utente.

User Comments restituisce il testo completo del commento?

text contiene un’anteprima di massimo 300 caratteri. Il campo url apre il commento completo e post_id identifica il post su cui è stato lasciato.

Popular Feed legge r/popular, che mescola i post in crescita in tutte le community. Per leggere una singola community, usa Subreddit Posts.

Pago se un utente non ha post?

Gli endpoint con addebito per risultato non hanno una quota base, quindi un risultato vuoto non costa nulla. Active Subreddits e Trending Searches sono chiamate a prezzo fisso di 0.5 crediti.

Dove posso confrontare i fornitori di dati Reddit?

Vedi alternative alle API di Reddit. Tutti gli endpoint Reddit di SocQ sono nella pagina della piattaforma Reddit, con le tariffe attuali nella pagina dei prezzi.

REDDIT API

Prova il flusso di lavoro con un URL pubblico di Reddit

Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.

Scopri le API di Reddit