Instagram Transcript
Los registros de Instagram Transcript contienen texto derivado del audio hablado de publicaciones y Reels públicos, con idioma, formato de salida, URL de origen, shortcode y hora de recopilación. Estos registros sirven para buscar contenido hablado, revisar accesibilidad, indexar contenido e investigar con trazabilidad del origen.
Funcionalidades de la Instagram Transcript API
- Varias URL de origenEnvíe una o más URL públicas de publicaciones o Reels de Instagram y reciba registros de transcripción de los medios que exponen contenido hablado.
- Resultados que reconocen los carruselesConserva registros de transcripción separados cuando una publicación de carrusel produce más de una transcripción de medios.
- Texto normalizado y procedenciaDevuelve el texto de la transcripción con el idioma, el formato de texto plano o WebVTT, la URL de origen, el identificador del medio, el shortcode y la hora de recopilación.
Parámetros de la Instagram Transcript API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una o más URL públicas de publicaciones o Reels de Instagram, separadas por comas o saltos de línea. |
Cómo usar la Instagram Transcript API
Envíe URL de medios públicos de Instagram como una tarea asíncrona, consulte su ID de tarea y luego lea todos los registros de transcripción normalizados con paginación por cursor.
- Prepare una o más URL públicas de publicaciones o Reels de Instagram.
- Envíe la lista urls por POST a /v1/instagram/transcript.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea /v1/tasks/{task_id}?limit=50, concilie los casos con cero o varios registros por URL de entrada y siga results.next_cursor mientras results.has_more sea 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 trueCasos de uso de la Instagram Transcript API
- Búsqueda de contenido hablado: Indexe el texto de las transcripciones con el idioma, las URL de origen y los shortcodes para poder buscar publicaciones y Reels públicos seleccionados por términos hablados.
- Investigación de publicaciones y Reels: Revise el texto de las transcripciones de un conjunto de URL seleccionado, conservando los identificadores de los medios y la hora de recopilación para verificar el origen.
- Revisión de subtítulos y accesibilidad: Use el texto devuelto y los metadatos de formato para preparar copias legibles o comprobar si los medios públicos seleccionados tienen registros de contenido hablado utilizables.
Consejos de expertos para la Instagram Transcript API
- Envíe URL canónicas de publicaciones o Reels públicos y elimine los duplicados exactos antes de iniciar una tarea, para que cada origen previsto se procese una sola vez.
- Concilie los resultados por ID de registro y no solo por URL, porque un medio sin voz puede no devolver ningún registro y una URL de carrusel puede devolver varios.
- Ramifique el análisis posterior según format; conserve las señales de tiempo de WebVTT cuando importe la estructura temporal y trate el texto plano como texto sin segmentar.
- Use collected_at para el linaje de la recopilación, porque created_at no se rellena con la hora de publicación del medio en Instagram.
- Al dividir el texto de la transcripción en fragmentos, conserve el ID del registro, la URL de origen, el shortcode, el idioma, el formato y collected_at en cada segmento derivado.
APIs relacionadas
Además de la Instagram Transcript API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.
- Instagram Posts API — Recolecta publicaciones públicas, contenido multimedia, hashtags, menciones, marcas de tiempo e interacción por nombre de usuario.
- Instagram Reels API — Recolecta Reels públicos, contenido multimedia, audio, hashtags, menciones e interacción por nombre de usuario.
- Instagram Tagged Posts API — Recolecta publicaciones públicas que etiquetan a los perfiles seleccionados, con autores, contenido multimedia, menciones, contexto de los usuarios etiquetados e interacción.
- Instagram Audio Reels API — Recolecta Reels públicos a partir de un ID numérico de audio conocido, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción visible y contexto del audio de origen.
- Instagram Highlight Items API — Obtiene los elementos de historias públicas guardadas a partir de IDs de historias destacadas conocidos, con texto, identidad del autor, contenido multimedia, marcas de tiempo, métricas visibles y contexto de origen.
- Instagram Post Info API — Consulta URLs conocidas de publicaciones, Reels o IGTV antiguos públicos, con descripciones, identidad del autor, contenido multimedia, marcas de tiempo, interacción visible y contexto de la entrada.
- 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