instagram/
highlight-items

Obtenga las historias públicas de IDs de historias destacadas de Instagram conocidos como registros normalizados, con texto, identidad del autor, métricas visibles, detalles de los medios y contexto de origen.

Instagram Highlight Items API

IDs de historias destacadas conocidos
Registros de historias
Medios y contexto de origen
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 Highlight Items

Instagram Highlight Items son historias guardadas dentro de las historias destacadas de perfiles públicos, con texto, identidad del autor, referencias de medios, marcas de tiempo y señales de interacción visibles. Estos registros sirven para inventariar el contenido de las historias destacadas, revisar medios, elaborar informes con trazabilidad del origen y comparar entre historias destacadas conocidas.

Funcionalidades de la Instagram Highlight Items API

  • Entrada de varias historias destacadasEnvíe uno o más IDs numéricos de historias destacadas, y se realiza una consulta al origen por cada identificador proporcionado.
  • Registros de historias normalizadosRecibe IDs de elemento, URL públicas, texto del título o la descripción, identidad del autor, métricas visibles, metadatos de medios y marcas de tiempo en una sola estructura de registro.
  • Atribución a la historia destacada de origenCada elemento devuelto conserva el ID de la historia destacada enviada en extra.highlight_id, de modo que los registros de varias historias destacadas siguen siendo distinguibles.

Parámetros de la Instagram Highlight Items API

ParámetrosObligatorioDescripción
highlight_idsObligatorioUno o más IDs de historias destacadas de Instagram conocidos, representados como cadenas numéricas no vacías, separados por comas o saltos de línea.

Cómo usar la Instagram Highlight Items API

Envíe IDs de historias destacadas conocidos como una tarea asíncrona, consulte su ID de tarea y luego lea los registros normalizados guardados con paginación de resultados por cursor.

  1. Prepare uno o más IDs numéricos vigentes de historias destacadas; si desconoce un ID, primero recopile Story Highlights por nombre de usuario y lea extra.highlight_id del registro contenedor devuelto.
  2. Envíe highlight_ids por POST a /v1/instagram/highlight-items.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea /v1/tasks/{task_id}?limit=50 y siga results.next_cursor mientras results.has_more sea true.
# Replace the documented sample with a current highlight ID before running.
curl -X POST "https://api.socq.ai/v1/instagram/highlight-items" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"highlight_ids":["18067016518767507"]}'

# 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 Highlight Items API

  • Inventario de historias guardadas: Organice los IDs de elemento, el texto, las URL públicas, las referencias de medios y las marcas de tiempo devueltos en un inventario revisable de historias destacadas conocidas.
  • Revisión de medios de historias destacadas: Inspeccione las URL de imágenes o videos, miniaturas, dimensiones, duración, descripciones y contexto del autor de las historias que cada historia destacada expone actualmente.
  • Comparación entre historias destacadas: Agrupe los registros por extra.highlight_id y compare los tipos de contenido, horas de publicación, autores y métricas visibles devueltos entre historias destacadas seleccionadas.

Consejos de expertos para la Instagram Highlight Items API

  • Si desconoce los IDs de historias destacadas, llame primero a instagram/story-highlights por nombre de usuario y use extra.highlight_id de los resultados exitosos; este endpoint no descubre IDs a partir de nombres de usuario.
  • Elimine los IDs duplicados antes de enviarlos, porque el recopilador realiza una consulta independiente por cada valor proporcionado.
  • No agregue results_limit; cada ID de historia destacada produce los elementos disponibles en su única respuesta del origen.
  • Use resource para distinguir highlight-items de story-highlights, porque ambas familias de registros normalizados usan el tipo story.
  • Trate el texto, los campos del autor, las métricas, los medios, las URL y las marcas de tiempo como opcionales, y acepte que las historias no disponibles o eliminadas no produzcan ningún registro.
  • Siga results.next_cursor solo para leer más registros almacenados de la tarea; no continúa la recopilación desde Instagram.

Además de la Instagram Highlight Items 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 Transcript API — Extrae el texto de la transcripción, el idioma, el formato, las URLs de origen y los shortcodes desde URLs de publicaciones o Reels públicos.
  • 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.

Explorar otras plataformas

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

Instagram Highlight Items API — FAQ

Instagram Highlight Items API es una interfaz programática para recuperar historias públicas a partir de IDs numéricos conocidos de historias destacadas de Instagram. Devuelve identidad normalizada del elemento, texto, autores, métricas visibles, metadatos de medios, marcas de tiempo y contexto de la historia destacada de origen.

Use un ID de historia destacada vigente que ya conozca o recopile primero Story Highlights por nombre de usuario. Los resultados exitosos de instagram/story-highlights exponen el identificador de origen como extra.highlight_id cuando está disponible; este endpoint no acepta nombres de usuario.

Un elemento normalizado puede contener ID, URL, texto, ID del autor, nombre de usuario y nombre, métricas visibles, metadatos de imagen o video, created_at, collected_at y extra.highlight_id. La disponibilidad de los campos depende de la respuesta pública del origen.

No se acepta results_limit, y el recopilador realiza una solicitud al origen por cada ID de historia destacada. El endpoint de resultados de la tarea sí puede paginar los registros guardados con limit y results.next_cursor.

Una historia destacada puede no contener registros expuestos actualmente, o sus historias pueden haberse eliminado, restringido, vuelto privadas o dejado de estar disponibles. La tarea solo guarda los registros presentes en la respuesta pública actual.

Se cobran 0.5 créditos por cada registro normalizado devuelto, sin cargo base. La estimación usa 20 registros por cada ID de historia destacada enviado, mientras que el uso final corresponde a los registros realmente devueltos.