Reddit Subreddit Details
Les subreddits forment des communautés spécialisées autour d’un thème, chacune avec ses règles de modération, son niveau d’activité et sa portée d’audience. La collecte de leurs métadonnées fournit le nombre d’abonnés, des estimations d’utilisateurs actifs par semaine, les règles de la communauté et l’image de l’icône.
Fonctionnalités de la Reddit Subreddit Details API
- Taille et engagement de la communautéExtrayez pour chaque subreddit le nombre total d’abonnés, d’utilisateurs actifs par semaine et de contributions hebdomadaires.
- Extraction des règles de modérationRécupérez le texte complet, au format markdown, des consignes de la communauté et des règles de publication qui encadrent la participation.
- Identité visuelle et éléments graphiquesCapturez les icônes de la communauté, les visuels d’en-tête, les noms affichés et la classification dans les catégories publicitaires.
- Traitement par lot de plusieurs URLEnvoyez un tableau d’URL /r/{subreddit} dans une seule requête pour une analyse groupée de communautés.
Paramètres de la Reddit Subreddit Details API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau d’URL de communautés Reddit publiques /r/{subreddit} dont il faut récupérer les métadonnées. |
Comment utiliser la Reddit Subreddit Details API
Envoyez une ou plusieurs URL de subreddits sous forme de tâche asynchrone, puis interrogez la tâche pour obtenir des profils de communautés normalisés.
- Préparez un ou plusieurs liens de subreddits publics, par exemple https://www.reddit.com/r/technology/.
- Envoyez une requête POST à /v1/reddit/subreddit-details avec le tableau urls.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut vaille succeeded.
- Lisez data.results.items pour obtenir les métadonnées de communautés normalisées.
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.Cas d’usage de la Reddit Subreddit Details API
- Mesure de l’audience d’un subreddit : Évaluez le nombre d’abonnés et de contributeurs actifs par semaine avant de lancer une prise de parole organique ou une session AMA.
- Contrôle de conformité aux règles : Analysez automatiquement les règles d’une communauté pour vérifier que vos publications respectent sa politique de publication.
- Constitution d’un annuaire thématique : Tenez à jour un catalogue de communautés Reddit avec leurs descriptions classées par catégorie et leurs icônes.
Conseils d’expert pour la Reddit Subreddit Details API
- Les URL doivent pointer vers la racine de la communauté (par exemple /r/technology/) et non vers des fils de publications individuelles.
- Les champs weekly_active_users et weekly_contributions des métadonnées extra constituent des indicateurs de vitalité fiables.
- Les noms de subreddits conservent leur casse d’origine dans les champs display_name et name.
- Associez cet endpoint à Reddit Subreddit Posts pour échantillonner le contenu en direct des communautés qui répondent à vos critères de taille.
API associées
En complément de la Reddit Subreddit Details API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Reddit.
- Reddit Posts API — Collectez le texte des publications publiques, auteurs, contexte de la communauté, médias, horodatages et l’engagement visible à partir d’URL Reddit prises en charge.
- Reddit Subreddit Posts API — Repérez les publications publiques à partir d’URL de subreddits, avec tri par nouveautés, meilleures ou tendances, limite de résultats par subreddit et contexte normalisé de la communauté et de l’engagement.
- Reddit Subreddit Search API
- Reddit User Profile API — Consultez des comptes Reddit par nom d’utilisateur, avec le karma total, de publication et de commentaire, les compteurs d’activité, l’âge du compte et les indicateurs du profil.
- Reddit User Active Subreddits API — Listez les subreddits dans lesquels un utilisateur Reddit est actif à partir de son nom, avec le nombre de membres et la description de chacun.
- Reddit Subreddit Rules API — Récupérez les règles numérotées de subreddits à partir de leurs URL, avec le titre court et le texte complet de chaque règle.