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ámetros | Obligatorio | Descripción |
|---|---|---|
highlight_ids | Obligatorio | Uno 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.
- 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.
- Envíe highlight_ids por POST a /v1/instagram/highlight-items.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- 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 trueCasos 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.
APIs relacionadas
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.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels API
- Instagram Stories 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