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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une 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.
- Préparez une ou plusieurs URL de publications ou de Reels Instagram publics.
- Envoyez le tableau urls en POST à /v1/instagram/transcript.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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 trueCas 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é.
API associées
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.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API