Reddit Subreddit Details
I subreddit formano community specializzate per argomento, con linee guida di moderazione distinte, attività dei contributori e portata del pubblico. Raccogliere i metadati di un subreddit restituisce il numero di iscritti, le stime degli utenti attivi settimanali, le regole della community e le immagini delle icone.
Funzionalità della Reddit Subreddit Details API
- Dimensioni ed engagement della communityEstrae per ogni subreddit il numero totale di iscritti, gli utenti attivi settimanali e il numero di contributi settimanali.
- Estrazione delle regole di moderazioneRecupera le linee guida complete della community in markdown e le regole di invio che disciplinano la partecipazione degli utenti.
- Branding e risorse graficheAcquisisce le immagini delle icone della community, le grafiche dell’intestazione, i nomi visualizzati e le classificazioni per categoria pubblicitaria.
- Batch con più URLInvia un array di URL /r/{subreddit} in una sola richiesta per un’analisi aggregata delle community.
Parametri della Reddit Subreddit Details API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array di URL di community Reddit pubbliche /r/{subreddit} di cui recuperare i metadati. |
Come usare la Reddit Subreddit Details API
Invia uno o più URL di subreddit come attività asincrona, poi interroga lo stato per ottenere i profili normalizzati delle community.
- Prepara uno o più link a subreddit pubblici, come https://www.reddit.com/r/technology/.
- Invia una richiesta POST a /v1/reddit/subreddit-details con l’array urls.
- Interroga /v1/tasks/{task_id} finché status diventa succeeded.
- Leggi data.results.items per recuperare i metadati normalizzati delle community.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/technology/"]}'
# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.Casi d’uso della Reddit Subreddit Details API
- Valutazione del pubblico di un subreddit: Valuta il numero di iscritti e dei contributori attivi settimanali prima di avviare attività organiche di contatto o AMA.
- Verifica del rispetto delle regole: Analizza le regole della community in modo programmatico per assicurarti che i contenuti inviati dagli utenti rispettino le policy di pubblicazione.
- Creazione di directory per argomento: Mantieni un catalogo aggiornato delle community di Reddit con descrizioni categorizzate e icone.
Consigli degli esperti per la Reddit Subreddit Details API
- Gli URL devono puntare alla radice della community (per esempio /r/technology/) e non ai singoli thread dei post.
- I campi weekly_active_users e weekly_contributions nei metadati extra offrono indicatori affidabili dello stato di salute della community.
- I nomi dei subreddit vengono conservati con le maiuscole originali sia nel campo display_name sia nel campo name.
- Combina con Reddit Subreddit Posts per campionare contenuti in tempo reale dalle community che rispettano i tuoi criteri di dimensione.
API correlate
Oltre alla Reddit Subreddit Details 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 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 Subreddit Search API
- Reddit User Profile API — Consulta account Reddit per username con karma totale, da post e da commenti, conteggi di attività, età dell’account e flag del profilo.
- Reddit User Active Subreddits API — Elenca i subreddit in cui è attivo un utente Reddit a partire da un solo username, con numero di membri e descrizioni.
- Reddit Subreddit Rules API — Recupera le regole numerate dei subreddit dai loro URL, con titolo breve e testo completo di ogni regola.