instagram/
story-highlights

Recopile los contenedores de historias destacadas públicas de Instagram a partir de nombres de usuario, con títulos, identidad del propietario, medios, cantidad de elementos e IDs de historias destacadas reutilizables.

Instagram Story Highlights API

Búsqueda por nombre de usuario
Contenedores de historias destacadas
IDs de historias destacadas reutilizables
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 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ámetrosObligatorioDescripción
usernamesObligatorioUno 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.

  1. Prepare uno o más nombres de usuario públicos de Instagram como identificadores y no como URL de perfil.
  2. Envíe usernames por POST a /v1/instagram/story-highlights.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. 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 true

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

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.

Explorar otras plataformas

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

Instagram Story Highlights API — FAQ

Instagram Story Highlights API es una interfaz programática para listar los contenedores de historias destacadas públicas de los nombres de usuario de Instagram enviados. Devuelve IDs de contenedor normalizados, títulos, identidad del propietario, medios, conteos públicos, cantidad de elementos e IDs de historias destacadas reutilizables.

Envíe una lista no vacía de identificadores de cuentas de Instagram. Se elimina una @ inicial, pero las URL de perfil no se convierten en nombres de usuario, así que normalice y elimine duplicados antes de enviarlos.

No. Devuelve contenedores de historias destacadas; use un extra.highlight_id numérico presente con instagram/highlight-items cuando necesite cada historia de un contenedor.

Un registro puede incluir el ID del contenedor, la URL, el título, el ID del propietario, el nombre de usuario y el nombre, medios expuestos directamente, conteos públicos habituales, created_at, collected_at, extra.highlight_id y extra.media_count.

No hay un results_limit controlado por quien llama ni continuación del proveedor. Cada nombre de usuario se solicita una vez, y cursor y limit en el endpoint de tareas solo paginan los registros normalizados ya guardados.

Un perfil público puede no tener historias destacadas guardadas, o la cuenta puede ser privada, no estar disponible o estar restringida. Trate una tarea con estado succeeded y un arreglo items vacío como un resultado válido sin datos.

Se cobran 0.5 créditos por cada historia destacada normalizada guardada, sin cargo base. Las estimaciones usan 20 resultados por cada nombre de usuario enviado, mientras que el uso final corresponde a los registros realmente guardados.