reddit/
trending-searches

Obtenez les recherches en tendance aujourd’hui sur Reddit sans aucune entrée, avec chaque terme recherché, son rang dans la liste de Reddit et un lien vers les résultats correspondants.

Reddit Trending Searches API

Aucune entrée requise
Liste classée
Liens vers les résultats
0,5 crédit par requête
Prêt
README

Par SocQ · Mis à jour le

Reddit Trending Searches

Les recherches tendance de Reddit forment la courte liste de termes que Reddit signale comme tendance du jour, en général six environ, chacun avec sa position dans la liste et un lien vers les résultats de recherche correspondants, et elles désignent souvent des événements d’actualité, des lancements de produits ou des moments culturels au fil de leur déroulement. Relevée au cours de la journée, cette liste montre ce que les utilisateurs de Reddit cherchent activement, ce qui alimente des tableaux de bord de tendances, une planification éditoriale réactive et des alertes lorsqu’un sujet suivi commence à monter.

Fonctionnalités de la Reddit Trending Searches API

  • Aucune entrée à préparerLe corps de la requête est vide : l’appel peut tourner depuis un planificateur sans rien à configurer.
  • Le classement dans l’ordre de Redditrank commence à 1 et suit l’ordre dans lequel Reddit présente ses recherches tendance.
  • Un lien de recherche pour chaque termekeyword contient le terme recherché et url ouvre les résultats de recherche Reddit correspondants : chaque tendance mène directement aux conversations qui la portent.

Paramètres de la Reddit Trending Searches API

Prêt à l’envoi

Cet endpoint n’exige aucun paramètre de requête. Envoyez l’objet JSON vide tel quel.

{}

Comment utiliser la Reddit Trending Searches API

Envoyez une requête vide et lisez la liste des tendances du moment.

  1. Envoyez un corps JSON vide {} en POST à /v1/reddit/trending-searches.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez keyword et rank dans results.items ; si has_more vaut true, récupérez la suite avec results.next_cursor.
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Cas d’usage de la Reddit Trending Searches API

  • Tenir un historique des tendances : Conservez keyword, rank et collected_at de chaque exécution pour représenter combien de temps les sujets restent dans la liste et comment ils montent ou descendent.
  • Planifier des publications et articles d’actualité : Consultez chaque matin les keyword du moment pour décider quels sujets en cours méritent ce jour-là une publication, un encart de newsletter ou un article explicatif.
  • Déclencher des alertes sur des sujets suivis : Comparez chaque keyword à une liste de termes de marque, de produit ou de secteur et prévenez l’équipe dès que l’un d’eux passe en tendance.

Conseils d’expert pour la Reddit Trending Searches API

  • Indexez les lignes stockées sur keyword et collected_at, car id est égal au terme recherché et le même terme réapparaît dans les relevés suivants.
  • Passez un keyword à Reddit Search API comme query lorsque vous avez besoin des publications derrière une tendance, avec leur texte, leurs auteurs et leur engagement.

En complément de la Reddit Trending Searches 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 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 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.
  • Reddit Answers API — Posez une question et obtenez la réponse IA de Reddit avec les commentaires cités, les publications sources et les subreddits recommandés.

Explorer d’autres plateformes

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

Reddit Trending Searches API — FAQ

Reddit Trending Searches API est une interface programmatique qui récupère, sans aucune entrée, les recherches que Reddit affiche comme tendance du jour. Elle renvoie chaque terme avec son rang et un lien vers les résultats de Reddit qui lui correspondent.

Six en général, classées à partir de 1 dans l’ordre où Reddit les présente : c’est la liste du moment telle que Reddit l’affiche.

Un forfait de 0,5 crédit par appel, quel que soit le nombre de recherches dans la liste.