instagram/
reels

Collectez les Reels Instagram publics d’un ou plusieurs noms d’utilisateur, avec légendes, médias, durée, audio, hashtags, mentions et engagement visible, le tout normalisé.

Instagram Reels API

Reels
Données publiques
Métadonnées des médias
0,52 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

Instagram Reels

Les Reels Instagram sont des vidéos courtes accompagnées de légendes, du contexte de leur créateur, de médias, d’audio, d’une durée, de hashtags, de mentions, de nombres de lectures et d’un engagement visible. Ces signaux créatifs et de performance servent à étudier les formats, comparer des créateurs, évaluer des campagnes et analyser les tendances.

Fonctionnalités de la Instagram Reels API

  • Collecte des Reels d’un profilRécupérez les Reels publics d’un ou plusieurs noms d’utilisateur Instagram dans une seule structure de réponse normalisée.
  • Contenu, médias et engagementRenvoie les légendes, horodatages, lectures, mentions J’aime, commentaires, partages, durées, miniatures, références vidéo, hashtags, mentions et métadonnées audio.
  • Plafond de résultats demandéServez-vous de results_limit pour plafonner le nombre de Reels demandés à chaque requête.
  • Limite aux données publiquesLes Reels privés, restreints, supprimés ou réservés aux comptes connectés restent hors du périmètre des résultats.

Paramètres de la Instagram Reels API

ParamètresObligatoireDescription
usernamesObligatoireNoms d’utilisateur Instagram publics, sans @, séparés par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal d’enregistrements que la tâche de collecte doit demander. Doit être un entier positif.

Comment utiliser la Instagram Reels API

Envoyez des noms d’utilisateur publics sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les Reels normalisés grâce à la pagination par curseur.

  1. Préparez un ou plusieurs noms d’utilisateur Instagram publics, sans @.
  2. Envoyez usernames et, au besoin, results_limit en POST à /v1/instagram/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 qu’il reste des enregistrements.
curl -X POST "https://api.socq.ai/v1/instagram/reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Cas d’usage de la Instagram Reels API

  • Étude des performances des Reels : Collectez les lectures, mentions J’aime, commentaires, partages, légendes et horodatages publics pour comparer les performances de vidéos courtes.
  • Repérage de créateurs : Parcourez les Reels publics de profils pertinents, puis enrichissez les créateurs retenus avec les API de profils ou de chronologie des publications.
  • Suivi de campagne : Suivez les Reels publics liés à un lancement, un hashtag, une tendance musicale, un brief de créateur ou un format de contenu récurrent.
  • Archivage de médias : Conservez les métadonnées, miniatures, URL source, durées, détails audio et dates de collecte des Reels publics pour vos outils de revue ou de reporting.
  • Analyse de l’audio : Exploitez les champs audio publics, lorsqu’ils sont disponibles, pour regrouper des sujets, appuyer une modération ou analyser la création.

Conseils d’expert pour la Instagram Reels API

  • Conservez les ID de Reels, shortcodes, URL et ID de tâche stables afin de pouvoir relancer et auditer vos collectes.
  • Choisissez des valeurs de results_limit prudentes et prévoyez un repli progressif pour collecter de longues listes de Reels sur des profils publics.
  • Attendez-vous à ce que certains Reels publics n’aient ni compteurs, ni références vidéo, ni détails audio, selon la disponibilité de la source.
  • Passez par l’API Search pour découvrir des profils, puis par l’API Reels pour récupérer les Reels publics des noms d’utilisateur retenus.
  • Ne bâtissez pas de workflow sur des comptes privés, des Reels restreints ou des champs réservés aux comptes connectés.

En complément de la Instagram 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 Comments API — Collectez les commentaires publics, auteurs, horodatages, mentions J’aime et réponses à partir d’URL de publications.
  • Instagram Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, liens, indicateurs de compte, catégories et nombres visibles.
  • 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 Audio Reels API — Collectez les Reels publics utilisant un ID audio numérique connu avec légendes, créateurs, médias, horodatages, engagement visible et contexte de l’audio source.

Explorer d’autres plateformes

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

Instagram Reels API — FAQ

Instagram Reels API collecte les Reels accessibles publiquement pour un ou plusieurs noms d’utilisateur Instagram. Elle renvoie des légendes, des informations sur l’auteur, des références de médias, la durée, l’audio, les hashtags, les mentions et les compteurs d’engagement visibles, le tout normalisé.

Les champs courants sont l’ID du Reel, le shortcode, l’URL, l’auteur, la légende, l’horodatage, les indicateurs visibles, les références de médias, la durée, les hashtags, les mentions, les métadonnées audio et la date de collecte.

L’endpoint actuel accepte un ou plusieurs noms d’utilisateur Instagram publics. Il n’accepte ni l’URL ni le shortcode d’un Reel isolé comme entrée de requête.

Non. Les Reels privés, restreints, supprimés ou réservés aux comptes connectés peuvent ne renvoyer que des données limitées, voire aucun enregistrement, car l’endpoint ne collecte que des résultats accessibles publiquement.

Elle peut renvoyer des références vidéo publiques lorsque les résultats publics des Reels exposent ces URL. Certains Reels n’exposent que des métadonnées ou des miniatures, donc les clients doivent prévoir l’absence de champs média.

Adoptez un rythme de requêtes prudent, des pages plus petites, la reprise par curseur et un repli progressif après un code 429 ou une réponse de pression similaire. Évitez d’interroger un même profil en boucle et à haut volume.

Oui, lorsque les résultats publics exposent des données audio. L’objet audio normalisé peut contenir un ID, un titre, un artiste et une URL.