Reddit Comments
Un commentaire Reddit est une réponse publique au sein de la discussion d’une publication, avec son texte, l’identité de son auteur, les références à la publication d’origine et au commentaire parent, le contexte de la communauté, les horodatages et les nombres visibles de votes et de réponses. Lus ensemble, ces champs rendent les commentaires renvoyés utiles pour analyser les réactions, cartographier les réponses, archiver avec un lien vers la source et comparer à des dates précises.
Fonctionnalités de la Reddit Comments API
- Commentaires d’une discussion préciseAcceptez l’URL d’une publication Reddit prise en charge ou un lien court redd.it, et obtenez les enregistrements des commentaires publics fournis pour cette discussion.
- Contenu et auteur des commentairesRenvoie pour chaque commentaire l’ID, l’URL publique, le texte et les identifiants de l’auteur lorsqu’ils sont disponibles, sous la forme d’un enregistrement normalisé distinct.
- Références à la publication et aux réponsesExpose post_id, post_url, parent_comment_id, community_name et input_url pour relier les commentaires renvoyés à leur source et entre eux.
- Instantané des réactions visiblesConserve upvotes_count et replies_count avec created_at et collected_at pour distinguer la date de publication de la date d’observation.
Paramètres de la Reddit Comments API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL de publications Reddit publiques, utilisant des chemins /r/{subreddit}/comments/{post_id} sur les hôtes Reddit pris en charge, ou des liens courts redd.it. |
Comment utiliser la Reddit Comments API
Envoyez des URL de publications Reddit publiques, suivez la tâche asynchrone et lisez les commentaires normalisés grâce à la pagination par curseur.
- Préparez une ou plusieurs URL de publications Reddit publiques prises en charge, ou des liens courts redd.it.
- Envoyez les liens dans urls à /v1/reddit/comments et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items, puis demandez le next_cursor renvoyé tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-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 trueCas d’usage de la Reddit Comments API
- Analyse qualitative des réactions : Analysez le texte des commentaires et les champs d’auteur disponibles pour repérer les arguments, les questions et les réactions récurrentes dans des discussions choisies.
- Cartographie des réponses renvoyées : Servez-vous des ID de commentaires et de parent_comment_id pour relier les réponses présentes dans les enregistrements renvoyés, sans supposer que le fil complet a été capturé.
- Archivage de commentaires avec lien source : Conservez les URL des commentaires, post_id, post_url, community_name et les horodatages pour que chaque réponse enregistrée garde le contexte de sa discussion.
- Comparaison horodatée des réactions : Comparez upvotes_count et replies_count entre les commentaires renvoyés en rattachant chaque observation à collected_at.
Conseils d’expert pour la Reddit Comments API
- Résolvez les liens redd.it et dédoublonnez par publication d’origine avant de regrouper les envois, afin de ne pas soumettre la même discussion sous plusieurs formes d’URL.
- N’envoyez pas results_limit : cet endpoint le rejette et enregistre les commentaires renvoyés pour chaque URL de publication acceptée.
- Utilisez parent_comment_id uniquement pour relier des enregistrements réellement présents dans le jeu de résultats, car il ne garantit pas la profondeur complète du fil.
- Acceptez que le texte, les champs d’auteur, parent_comment_id, community_name, les horodatages et les indicateurs soient null lorsque la source publique les omet.
- Poursuivez avec next_cursor jusqu’à ce que has_more vaille false, pour ne manquer aucun commentaire d’une tâche terminée à la frontière des pages de résultats.
API associées
En complément de la Reddit Comments 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 Search API — Recherchez des publications Reddit publiques par requête textuelle et période de publication, avec contenu, auteurs, contexte de la communauté, horodatages, médias et engagement visible normalisés.
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit User Comments API — Collectez l’historique des commentaires d’un utilisateur Reddit à partir de son nom, avec des extraits de 300 caractères, les scores, les liens des commentaires et les ID de publications.