instagram/
stories

Recopile las historias que una cuenta pública de Instagram está mostrando en este momento a partir de su nombre de usuario, con la imagen o el video de cada historia, las horas de publicación y de vencimiento y los stickers de enlace.

Instagram Stories API

Entrada por nombre de usuario
Historias activas
Stickers de enlace
0.5 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 Stories

Las historias de Instagram son fotos y videos que una cuenta comparte durante 24 horas, y a menudo incluyen un sticker de enlace, una cuenta etiquetada o una oferta por tiempo limitado que nunca llega al feed principal. Guardarlas mientras están activas ofrece a los equipos de marca, marketing e investigación un registro de lanzamientos, promociones y actividad de creadores que de otro modo desaparecería.

Funcionalidades de la Instagram Stories API

  • Todo lo que la cuenta tiene activoUn nombre de usuario devuelve todas las historias que la cuenta tiene publicadas en el momento en que usted envía la solicitud.
  • Medios listos para archivarCada historia incluye la URL de su imagen o video, el ancho y el alto, y una imagen de portada, de modo que el contenido se pueda almacenar o revisar más adelante.
  • Cuándo se publicó y cuándo desapareceLa hora de publicación llega como published_at y la de vencimiento como extra.expires_at, lo que le indica exactamente cuánto tiempo tiene antes de la siguiente recopilación.
  • Los enlaces y las menciones permanecen con la historiaLos destinos de los stickers de enlace aparecen en extra.link_urls y las cuentas etiquetadas en extra.mentions, asociados a la historia que los contenía.

Parámetros de la Instagram Stories API

ParámetrosObligatorioDescripción
usernameObligatorioNombre de usuario de la cuenta pública de Instagram cuyas historias actuales desea obtener. La @ inicial es opcional.

Cómo usar la Instagram Stories API

Envíe un nombre de usuario, espere a que la tarea termine y lea las historias en el resultado de la tarea.

  1. Elija la cuenta pública que desea revisar, por ejemplo natgeo.
  2. Envíe por POST {"username": "natgeo"} a /v1/instagram/stories y conserve el task_id de la respuesta.
  3. Llame a GET /v1/tasks/{task_id} cada pocos segundos hasta que status sea succeeded.
  4. Lea las historias en results.items; cuando results.has_more sea true, pase results.next_cursor para obtener la siguiente página.
curl -X POST "https://api.socq.ai/v1/instagram/stories" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"natgeo"}'

# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the stories once status is succeeded.

Casos de uso de la Instagram Stories API

  • Archivo diario de historias: Recopile las historias de una marca una o dos veces al día y conserve los medios y las horas de publicación, para que cada historia siga siendo revisable después de vencer.
  • Seguimiento de promociones: Siga las URL de los stickers de enlace que los competidores agregan a sus historias para ver qué productos, ofertas y páginas de destino están impulsando esta semana.
  • Verificación de campañas con creadores: Compare la hora, los medios y el sticker de enlace de la historia de un creador de contenido con el brief para confirmar que la historia acordada se publicó.

Consejos de expertos para la Instagram Stories API

  • Programe las ejecuciones con menos de 24 horas de diferencia para que cada historia se capture al menos una vez mientras está activa.
  • Descargue poco después de la recopilación las imágenes y los videos que desee conservar, porque los enlaces a los medios de las historias son direcciones temporales de CDN.
  • Cuando vuelva a recopilar la misma cuenta, use el id de la historia para omitir las que ya almacenó.
  • Para las historias que una cuenta mantiene en su perfil, use Instagram Story Highlights e Instagram Highlight Items.

Además de la Instagram Stories 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 Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, enlaces, indicadores de cuenta, categorías y conteos visibles.
  • 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 Story Highlights API — Lista las historias destacadas públicas por nombre de usuario, con títulos, contexto del propietario, cantidad de elementos multimedia e IDs de historias destacadas reutilizables.
  • Instagram Similar Accounts API — Lista las cuentas que Instagram sugiere como similares a un nombre de usuario, con nombres de usuario, nombres, avatares y estado de verificación.

Explorar otras plataformas

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

Instagram Stories API — FAQ

Instagram Stories API es una interfaz programática para recopilar las historias que una cuenta pública de Instagram tiene activas en este momento, usando su nombre de usuario como entrada. Devuelve el ID y el enlace de cada historia, la imagen o el video, la imagen de portada, el autor y la hora de publicación.

Sí. Envíe el nombre de usuario de una cuenta pública y sus historias regresan como datos, sin necesidad de iniciar sesión en Instagram de su parte.

Cuando una historia incluye un sticker de enlace, la URL de destino del sticker se devuelve en extra.link_urls para esa historia.

Las historias permanecen 24 horas, por lo que recopilarlas una o dos veces al día captura cada una mientras está activa.

La tarea termina con un mensaje de que no se encontró el perfil, y los créditos retenidos para ella se devuelven a su saldo.

Se pagan 0.5 créditos por cada historia devuelta, y una solicitud que no encuentra historias activas no tiene costo.