Reddit Subreddit Rules
Les règles d’un subreddit sont les consignes de publication numérotées que chaque communauté Reddit se fixe, chacune avec un titre court que les modérateurs affichent dans le menu de signalement et une explication complète de ce qu’elle couvre. Lues avant de publier, elles indiquent quels types de publications une communauté accueille ou retire, ce qui permet de vérifier la conformité avant un lancement, de partager un règlement commun aux équipes qui gèrent plusieurs comptes et de comparer les communautés entre elles.
Fonctionnalités de la Reddit Subreddit Rules API
- Plusieurs subreddits par requêteurls accepte des adresses de communautés comme https://www.reddit.com/r/AskReddit/, et chaque subreddit revient sous forme d’une ligne avec son nom en r/ et son url.
- Les règles dans leur ordre numérotérules conserve l’ordre adopté par la communauté : la première entrée est sa première règle, et une référence comme « règle 3 » correspond directement au troisième élément.
- Titre court et texte complet pour chaque règlerules.name contient le titre court affiché par les modérateurs dans le menu de signalement, rules.description le texte complet de la règle et rules.id son identifiant.
Paramètres de la Reddit Subreddit Rules API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une ou plusieurs URL de subreddits au format https://www.reddit.com/r/{name}/ ; les adresses old.reddit.com et new.reddit.com fonctionnent aussi. |
Comment utiliser la Reddit Subreddit Rules API
Envoyez des URL de subreddits et lisez une liste de règles par communauté.
- Envoyez {"urls": ["https://www.reddit.com/r/AskReddit/"]} en POST à /v1/reddit/subreddit-rules.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez le tableau rules de chaque subreddit dans results.items et suivez results.next_cursor tant que has_more vaut true.
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/"]}'Cas d’usage de la Reddit Subreddit Rules API
- Vérifier une publication de lancement au regard des règles : Lisez rules.description pour chaque subreddit visé avant une publication produit ou un AMA, afin de confirmer que le format, les liens et la formulation sont autorisés.
- Tenir un règlement pour chaque communauté où l’équipe publie : Conservez les règles de chaque subreddit avec collected_at pour que toutes les personnes qui publient depuis les comptes de l’entreprise travaillent sur la même version à jour.
- Comparer les règles d’une communauté à l’autre : Cherchez dans rules.name et rules.description de nombreux subreddits des termes comme promotion, liens ou flair pour voir quelles communautés conviennent à une campagne.
Conseils d’expert pour la Reddit Subreddit Rules API
- Réduisez chaque URL à la racine de la communauté /r/{name}/ avant l’envoi, car un lien de publication ou tout autre chemin dans la liste fait rejeter toute la requête.
- Affichez rules.description en Markdown, puisqu’il conserve les listes, la mise en forme et les liens rédigés par les modérateurs, y compris les liens vers les versions longues d’une règle dans le wiki.
- Comparez rules.id et rules.description d’une exécution à l’autre pour repérer les règles ajoutées, supprimées ou réécrites avant la mise en ligne de votre prochaine publication.
API associées
En complément de la Reddit Subreddit Rules 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 Details API
- 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.