instagram/
trending-reels

Collectez l’ensemble actuel de Reels exposé par le fil des tendances, sans aucun sélecteur, avec légendes, auteurs, médias, horodatages et engagement visible.

Instagram Trending Reels API

Aucun sélecteur à fournir
Instantané du fil actuel
Reels normalisés
0,5 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

Instagram Trending Reels

Les Reels tendance d’Instagram sont des vidéos courtes publiques mises en avant dans un fil de découverte actuel, avec légendes, identité du créateur, médias, horodatages et signaux d’engagement visibles. Ces enregistrements instantanés servent à examiner la création, surveiller la découverte, comparer des contenus et alimenter une recherche plus poussée sur les Reels.

Fonctionnalités de la Instagram Trending Reels API

  • Instantané du fil sans sélecteurCapturez l’ensemble actuel de Reels exposé par le fil des tendances sans fournir de requête, de compte, de hashtag, de région ni de filtre de date.
  • Reels normalisésRecevez dans une même structure l’identité du Reel, les URL publiques, les légendes, le contexte de l’auteur, les métadonnées des médias, les horodatages et les nombres visibles de mentions J’aime, de commentaires, de vues et de lectures.
  • Suppression des doublonsFusionnez les lignes de fil répétées selon l’ID du Reel, la clé primaire ou le shortcode avant la sauvegarde des enregistrements normalisés.

Paramètres de la Instagram Trending Reels 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 Instagram Trending Reels API

Envoyez un objet JSON vide sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les enregistrements de l’instantané sauvegardé grâce à la pagination des résultats par curseur.

  1. Préparez un objet JSON vide.
  2. Envoyez le corps de la requête en POST à /v1/instagram/trending-reels.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/trending-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Instagram Trending Reels API

  • Inventaire de la découverte du moment : Sauvegardez les ID de Reels, URL publiques, légendes, identités de créateurs et dates de collecte comme trace consultable de l’instantané du fil actuel.
  • Analyse de la création en vidéo courte : Examinez le texte des légendes, le contexte des auteurs, les miniatures, les références vidéo, les dimensions et la durée pour passer en revue les exemples créatifs présents dans un instantané.
  • Comparaison de l’engagement au sein d’un instantané : Comparez les mentions J’aime, commentaires, vues, lectures et heures de création visibles pour les Reels renvoyés par une même tâche de collecte.

Conseils d’expert pour la Instagram Trending Reels API

  • N’envoyez qu’un objet vide ; les champs query, region, username, hashtag, date et results_limit sont refusés.
  • Voyez chaque réponse comme l’instantané du fil tel que la source le définit au moment de la collecte, et non comme une formule de classement officielle ni une garantie de couverture mondiale ou régionale.
  • Ne demandez pas de page suivante en amont ; results.next_cursor ne fait que parcourir les enregistrements déjà sauvegardés pour la tâche terminée.
  • Si vous conservez des instantanés répétés, dédoublonnez d’une tâche à l’autre avec des ID ou des URL de Reels stables, car la suppression des doublons ne s’applique qu’au sein de chaque réponse de fil.
  • Stockez collected_at avec chaque résultat quand vous bâtissez votre propre série temporelle, car cet endpoint ne fournit ni instantanés historiques ni planification.
  • Traitez les légendes, champs d’auteur, compteurs, médias, URL et heures de création comme des champs publics nullables.

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

  • Instagram Posts API — Collectez les publications publiques, médias, hashtags, mentions, horodatages et l’engagement par nom d’utilisateur.
  • Instagram Reels API — Collectez par nom d’utilisateur les Reels publics, médias, audio, hashtags, mentions et l’engagement.
  • Instagram Comments API — Collectez les commentaires publics, auteurs, horodatages, mentions J’aime et réponses à partir d’URL de publications.
  • Instagram Tagged Posts API — Collectez les publications publiques qui identifient des profils donnés, avec auteurs, médias, mentions, contexte des comptes identifiés et engagement.
  • Instagram Transcript API — Extrayez le texte de transcription, la langue, le format, les URL sources et les shortcodes à partir d’URL de publications ou de Reels publics.
  • Instagram Post Info API — Consultez des URL connues de publications, de Reels ou d’anciens IGTV publics avec légendes, identité de l’auteur, médias, horodatages, engagement visible et contexte de la saisie.

Explorer d’autres plateformes

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

Instagram Trending Reels API — FAQ

Instagram Trending Reels API est une interface programmatique qui collecte l’ensemble public actuel de Reels exposé par le fil des tendances, sans entrée de sélection. Elle renvoie l’identité normalisée des Reels, les légendes, les auteurs, les médias, les horodatages et l’engagement visible.

Le contenu de la requête est un objet JSON vide ; les champs query, region, username, hashtag, date et results_limit ne sont pas acceptés.

Tendance désigne l’ensemble de Reels renvoyé par le fil de découverte configuré au moment de la collecte. L’endpoint ne publie aucune formule de classement et ne garantit ni couverture mondiale, ni personnalisation régionale, ni ordre stable.

Un enregistrement normalisé peut contenir l’ID et l’URL du Reel, le texte de la légende, l’ID, le nom d’utilisateur, le nom et l’avatar de l’auteur, les nombres visibles de mentions J’aime, de commentaires, de vues et de lectures, les métadonnées des médias, created_at, collected_at et le type de produit.

Aucun paramètre results_limit ni de continuation en amont n’est accepté, et le collecteur n’effectue qu’une requête de fil. L’endpoint de résultats de tâche peut toutefois paginer les enregistrements déjà sauvegardés avec limit et results.next_cursor.

Non. Chaque tâche capture le fil exposé au moment de la collecte ; conservez les résultats avec collected_at si votre application doit comparer des instantanés collectés indépendamment.

La facturation est de 0,5 crédit par enregistrement normalisé renvoyé, sans frais de base. L’envoi repose sur une estimation de 20 enregistrements, tandis que la consommation finale suit les enregistrements réellement renvoyés.