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ámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | Nombre 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.
- Elija la cuenta pública que desea revisar, por ejemplo natgeo.
- Envíe por POST {"username": "natgeo"} a /v1/instagram/stories y conserve el task_id de la respuesta.
- Llame a GET /v1/tasks/{task_id} cada pocos segundos hasta que status sea succeeded.
- 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.
APIs relacionadas
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.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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