Instagram Story Highlights
Las historias destacadas de Instagram son colecciones de historias guardadas en perfiles públicos, organizadas por títulos, con contexto del propietario, medios de portada y cantidad de elementos. Estos registros de contenedores sirven para inventariar las categorías de un perfil, comparar entre cuentas y seleccionar historias destacadas para revisar sus elementos.
Funcionalidades de la Instagram Story Highlights API
- Inventario de historias destacadas de varios perfilesEnvíe uno o más nombres de usuario de Instagram para listar los contenedores de historias destacadas públicas que expone cada cuenta, conservando el contexto del propietario.
- Identidad y contexto del contenedorRecibe IDs de historias destacadas normalizados, títulos, URL, identidad del propietario, medios expuestos directamente, marcas de tiempo, conteos públicos y totales de elementos informados.
- Paso al nivel de elementosUse extra.highlight_id para conservar la relación con el contenedor y pasar los IDs numéricos de historias destacadas a los flujos de recopilación por elemento.
Parámetros de la Instagram Story Highlights API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Uno o más nombres de usuario públicos de Instagram como identificadores no vacíos; se acepta una @ inicial y se elimina antes de la recopilación. |
Cómo usar la Instagram Story Highlights API
Envíe nombres de usuario de cuentas públicas como una tarea asíncrona, consulte su ID de tarea y luego lea los contenedores de historias destacadas normalizados con paginación de resultados por cursor.
- Prepare uno o más nombres de usuario públicos de Instagram como identificadores y no como URL de perfil.
- Envíe usernames por POST a /v1/instagram/story-highlights.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea data.results.items y siga results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/instagram/story-highlights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Instagram Story Highlights API
- Inventario de categorías de un perfil público: Organice los títulos, la identidad del propietario, las URL y los conteos de medios de las historias destacadas en un inventario de las categorías de historias guardadas visibles en un perfil.
- Comparación de historias destacadas entre cuentas: Compare los títulos de los contenedores, los totales de elementos informados, las referencias de medios y las marcas de tiempo disponibles entre los nombres de usuario públicos enviados.
- Selección de colecciones de historias: Use extra.highlight_id junto con los títulos y media_count para seleccionar contenedores numéricos de historias destacadas y recuperar después sus elementos.
Consejos de expertos para la Instagram Story Highlights API
- Normalice los nombres de usuario antes de enviarlos: elimine las @ iniciales y los duplicados, porque las URL de perfil no se convierten en nombres de usuario.
- Prevea una solicitud de lista de historias destacadas por nombre de usuario, sin results_limit ni continuación del proveedor, por lo que la lista de contenedores disponible determina los registros recopilados de cada cuenta.
- Use el next_cursor del resultado de la tarea solo para paginar los registros normalizados guardados; no solicita a Instagram otra página de historias destacadas.
- Pase a instagram/highlight-items solo los valores numéricos de extra.highlight_id que estén presentes cuando necesite cada historia por separado.
- Considere que un resultado vacío puede significar que no hay historias destacadas o que el perfil no está disponible, y no dé por sentados los medios, métricas, URL ni marcas de tiempo opcionales.
APIs relacionadas
Además de la Instagram Story Highlights 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 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 Stories API — Recolecta las historias que una cuenta pública tiene activas en este momento, por nombre de usuario, con su contenido multimedia, horas de publicación y horas de vencimiento.
- 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 Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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