reddit/
posts

Collectez des publications Reddit publiques à partir d’URL prises en charge et obtenez, sous forme d’enregistrements normalisés, titres, textes, auteurs, contexte de communauté, médias, horodatages et engagement visible.

Reddit Posts API

Entrée par URL de publication
Contexte de communauté
Instantané d’engagement
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Reddit Posts

Une publication Reddit est une contribution à une communauté, dont la page publique peut afficher un titre, un corps de texte, un auteur, un flair, des médias, une date de mise en ligne et des signaux visibles de votes et de commentaires. En rattachant ces champs au subreddit et à la date de capture, on peut exploiter chaque publication pour la vérification de source, l’analyse de contenu et la comparaison horodatée.

Fonctionnalités de la Reddit Posts API

  • Résolution directe d’une publicationTransformez l’URL d’une discussion Reddit acceptée ou un lien court redd.it en enregistrement normalisé de cette publication publique ; les pages d’accueil de subreddit et les chemins sans rapport sont rejetés.
  • Contenu de la publication et attributionRenvoie l’ID de la publication, son URL publique, son titre, son texte et les identifiants d’auteur disponibles, pour remonter à la source de chaque élément.
  • Contexte du subreddit et classificationExpose le flair, ainsi que le nom, l’URL et le nombre visible de membres de la communauté dans extra lorsque la source les fournit.
  • Médias, engagement et date de captureRéunit dans un même instantané horodaté les références média, created_at, collected_at, upvotes_count, comments_count et upvote_ratio.

Paramètres de la Reddit Posts API

ParamètresObligatoireDescription
urlsObligatoireListe 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 Posts API

Envoyez les publications publiques exactes dont vous avez besoin, suivez la tâche asynchrone et lisez les enregistrements normalisés grâce à la pagination par curseur.

  1. Rassemblez une ou plusieurs URL de publications Reddit publiques, avec un chemin de commentaires pris en charge ou un lien court redd.it.
  2. Envoyez les liens dans urls à /v1/reddit/posts et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à la réussite de la tâche ou un échec.
  4. 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/posts" \
  -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 true

Cas d’usage de la Reddit Posts API

  • Revue de publications avec leur source : Conservez les ID, URL, titres, textes et champs d’auteur des publications pour que les relecteurs puissent retrouver précisément les contributions publiques incluses dans une analyse.
  • Comparaison d’un sujet entre communautés : Regroupez titres et textes par community_name et par tag pour examiner comment un sujet défini est présenté dans des subreddits choisis.
  • Suivi horodaté de l’engagement : Stockez upvotes_count, comments_count et upvote_ratio avec collected_at pour comparer des instantanés répétés, sans considérer ces valeurs comme définitives.

Conseils d’expert pour la Reddit Posts API

  • Résolvez les liens redd.it et dédoublonnez par identifiant de publication avant de regrouper les envois, car un lien court et l’URL complète d’une discussion peuvent désigner la même publication.
  • Utilisez cet endpoint lorsque vous connaissez déjà les URL des publications ; il n’accepte ni pages d’accueil de subreddit, ni requêtes de recherche, ni contrôles de tri, ni results_limit.
  • Prévoyez que l’auteur, les médias, le tag, les détails de la communauté, les horodatages et les indicateurs soient null lorsque la source publique ne les expose pas.
  • Stockez collected_at à côté des indicateurs d’engagement visibles pour comparer des instantanés ultérieurs sans écraser leurs heures d’observation.

En complément de la Reddit Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Reddit.

  • Reddit Comments API — Collectez le texte des commentaires publics, auteurs, références à la publication et au commentaire parent, contexte de la communauté, horodatages et engagement visible à partir d’URL de publications 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 User Posts API — Collectez l’historique des publications d’un utilisateur Reddit à partir de son nom, trié par new, top ou hot, avec titre et corps, score, commentaires et médias.
  • Reddit Popular Feed API — Collectez les publications de r/popular dans l’ordre hot, best, new, rising ou top, avec titre et corps, auteur, score, commentaires et médias.

Explorer d’autres plateformes

Combinez les données Reddit avec les données publiques d’autres plateformes sociales prises en charge.

Reddit Posts API — FAQ

Reddit Posts API transforme des URL de publications Reddit publiques prises en charge en enregistrements normalisés contenant le contenu de la publication, le contexte de l’auteur et du subreddit, les médias, les horodatages et les indicateurs d’engagement visibles.

Envoyez une URL http ou https sur reddit.com, www.reddit.com, old.reddit.com ou new.reddit.com dont le chemin commence par /r/{subreddit}/comments/{post_id}. Les liens courts redd.it et www.redd.it sont aussi acceptés.

Non. Reddit Posts API résout les URL de publications précises fournies dans urls ; elle n’accepte ni pages d’accueil de subreddit, ni mots-clés, ni contrôles de tri pour la découverte.

Non. Cet endpoint n’accepte que urls, car chaque entrée désigne une publication précise et non un fil de publications à limiter.

Non. Chaque enregistrement peut contenir un comments_count visible, mais ni le texte des commentaires ni leurs auteurs.

L’auteur, les médias, le flair, le contexte de communauté, la date de publication et les valeurs d’engagement peuvent être null ou vides lorsque la source publique n’expose aucune valeur exploitable.

Chaque publication renvoyée coûte 0,5 crédit SocQ. Un jeu de résultats vide n’entraîne aucun frais de résultat.