instagram/
transcript

Extraiga registros de transcripción de URL públicas de publicaciones y Reels de Instagram, con texto, idioma, formato, URL de origen y shortcodes en una estructura normalizada.

Instagram Transcript API

Transcripciones de publicaciones y Reels
Texto plano o WebVTT
Registros vinculados al origen
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioUna 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.

  1. Prepare una o más URL públicas de publicaciones o Reels de Instagram.
  2. Envíe la lista urls por POST a /v1/instagram/transcript.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Instagram con datos públicos de otras plataformas sociales compatibles.

Instagram Transcript API — FAQ

Instagram Transcript API es una interfaz programática para extraer registros de transcripción de URL públicas de publicaciones o Reels de Instagram. Devuelve texto, idioma, formato de texto plano o WebVTT, URL de origen, identificadores de medios, shortcodes y hora de recopilación.

Envíe una lista urls no vacía con URL públicas de publicaciones o Reels de Instagram. El endpoint no acepta nombres de usuario, consultas ni un campo url individual.

No. Los medios sin voz pueden no devolver ningún registro de transcripción, mientras que una publicación de carrusel puede producir más de un registro.

No. Este endpoint solo acepta urls; el idioma se devuelve como metadato del registro cuando el origen lo expone.

format es plaintext, salvo que el contenido de la transcripción devuelta empiece con marcado WebVTT, en cuyo caso es webvtt. Los registros también pueden incluir text, language, ID, URL de origen, shortcode, created_at como null y collected_at.

Se cobran 0.7 créditos por cada registro de transcripción devuelto, sin cargo base. La estimación usa la cantidad de URL enviadas, mientras que el uso final corresponde a los registros reales, incluidos los varios registros de un carrusel.