instagram/
transcript

Extrayez des transcriptions à partir d’URL de publications et de Reels Instagram publics, avec texte, langue, format, URL source et shortcodes dans une structure normalisée.

Instagram Transcript API

Transcriptions de publications et de Reels
Plaintext ou WebVTT
Enregistrements liés à leur source
0,7 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 Transcript

Les transcriptions Instagram sont des enregistrements dont le texte provient de l’audio parlé des publications et des Reels publics, avec la langue, le format de sortie, l’URL source, le shortcode et la date de collecte. Elles servent à chercher dans les contenus parlés, à contrôler l’accessibilité, à indexer des contenus et à mener des recherches dont chaque résultat renvoie à sa source.

Fonctionnalités de la Instagram Transcript API

  • Plusieurs URL sourceEnvoyez une ou plusieurs URL de publications ou de Reels Instagram publics et recevez des transcriptions pour les médias qui contiennent de la parole.
  • Résultats adaptés aux carrouselsConserve des transcriptions distinctes lorsqu’une même publication en carrousel produit la transcription de plusieurs médias.
  • Texte normalisé et provenanceRenvoie le texte de la transcription avec la langue, le format plaintext ou WebVTT, l’URL source, l’identifiant du média, le shortcode et la date de collecte.

Paramètres de la Instagram Transcript API

ParamètresObligatoireDescription
urlsObligatoireUne ou plusieurs URL de publications ou de Reels Instagram publics, séparées par des virgules ou des retours à la ligne.

Comment utiliser la Instagram Transcript API

Envoyez des URL de médias Instagram publics sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez chaque transcription normalisée grâce à la pagination par curseur.

  1. Préparez une ou plusieurs URL de publications ou de Reels Instagram publics.
  2. Envoyez le tableau urls en POST à /v1/instagram/transcript.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50, rapprochez les cas où une URL donne zéro ou plusieurs enregistrements, et suivez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/reel/DHsD6HGqJhp/"]}'

# 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 Transcript API

  • Recherche dans les contenus parlés : Indexez le texte des transcriptions avec la langue, les URL source et les shortcodes pour retrouver des publications et des Reels publics choisis à partir de termes prononcés.
  • Étude de publications et de Reels : Parcourez le texte des transcriptions d’un jeu d’URL sélectionnées tout en gardant identifiants de médias et date de collecte pour vérifier les sources.
  • Sous-titrage et accessibilité : Servez-vous du texte renvoyé et des métadonnées de format pour préparer des copies lisibles ou vérifier si des médias publics choisis disposent d’enregistrements exploitables de contenu parlé.

Conseils d’expert pour la Instagram Transcript API

  • Envoyez des URL canoniques de publications ou de Reels publics et supprimez les doublons exacts avant de lancer une tâche, pour que chaque source voulue soit traitée une seule fois.
  • Rapprochez les résultats par ID d’enregistrement plutôt que par URL seule, car un média muet peut ne renvoyer aucun enregistrement et une même URL de carrousel peut en renvoyer plusieurs.
  • Aiguillez l’analyse en aval selon format : conservez les repères temporels WebVTT quand la structure du timing compte, et traitez plaintext comme un texte non segmenté.
  • Utilisez collected_at pour tracer l’origine de la collecte, car created_at n’est pas renseigné avec la date de publication du média sur Instagram.
  • Si vous découpez le texte d’une transcription, gardez l’ID d’enregistrement, l’URL source, le shortcode, la langue, le format et collected_at avec chaque segment dérivé.

En complément de la Instagram Transcript 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 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 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.
  • Instagram Highlight Items API — Récupérez les éléments de stories publiques enregistrés à partir d’ID de stories à la une connus, avec texte, identité de l’auteur, médias, horodatages, indicateurs visibles et contexte source.
  • 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 Transcript API — FAQ

Instagram Transcript API est une interface programmatique qui extrait des transcriptions à partir d’URL de publications ou de Reels Instagram publics. Elle renvoie le texte, la langue, le format plaintext ou WebVTT, les URL source, les identifiants de médias, les shortcodes et la date de collecte.

Envoyez un tableau urls non vide contenant des URL de publications ou de Reels Instagram publics. L’endpoint n’accepte ni noms d’utilisateur, ni requêtes de recherche, ni champ url unique.

Non. Un média sans parole peut ne renvoyer aucune transcription, tandis qu’une publication en carrousel peut produire plus d’un enregistrement.

Non. Cet endpoint n’accepte que urls ; la langue est renvoyée comme métadonnée de l’enregistrement lorsque la source l’expose.

format vaut plaintext, sauf si le contenu renvoyé commence par un balisage WebVTT, auquel cas il vaut webvtt. Les enregistrements peuvent aussi contenir text, language, l’ID, l’URL source, le shortcode, created_at à null et collected_at.

La facturation est de 0,7 crédit par transcription renvoyée, sans frais de base. L’estimation repose sur le nombre d’URL envoyées, tandis que la consommation finale suit les enregistrements réels, y compris plusieurs enregistrements pour un carrousel.