instagram/
highlight-items

Récupérez les éléments de story publics à partir d’ID de stories à la une Instagram connus, sous forme d’enregistrements normalisés avec texte, identité de l’auteur, indicateurs visibles, détails des médias et contexte de la source.

Instagram Highlight Items API

ID de stories à la une connus
Enregistrements d’éléments de story
Médias et contexte de la source
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Instagram Highlight Items

Les Highlight Items Instagram sont des stories conservées dans les stories à la une d’un profil public, avec texte, identité de l’auteur, références de médias, horodatages et signaux d’engagement visibles. Ces enregistrements servent à inventorier les contenus mis à la une, à examiner les médias, à produire des rapports qui citent leur source et à comparer des stories à la une connues.

Fonctionnalités de la Instagram Highlight Items API

  • Entrée multi-stories à la uneEnvoyez un ou plusieurs ID de stories à la une numériques ; une recherche en amont est effectuée pour chaque identifiant fourni.
  • Éléments de story normalisésRecevez dans une seule structure d’enregistrement les ID d’éléments, URL publiques, titres ou légendes, identités d’auteurs, indicateurs visibles, métadonnées de médias et horodatages.
  • Attribution à la story à la une sourceChaque élément renvoyé conserve l’ID de story à la une envoyé dans extra.highlight_id, ce qui permet de distinguer les enregistrements issus de plusieurs stories à la une.

Paramètres de la Instagram Highlight Items API

ParamètresObligatoireDescription
highlight_idsObligatoireUn ou plusieurs ID de stories à la une Instagram connus, représentés par des chaînes numériques non vides, séparés par des virgules ou des retours à la ligne.

Comment utiliser la Instagram Highlight Items API

Envoyez des ID de stories à la une connus sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les enregistrements normalisés sauvegardés avec la pagination par curseur de résultats.

  1. Préparez un ou plusieurs ID de stories à la une numériques actuels ; si un ID est inconnu, collectez d’abord les Story Highlights par nom d’utilisateur et lisez extra.highlight_id dans l’enregistrement conteneur renvoyé.
  2. Envoyez highlight_ids en POST à /v1/instagram/highlight-items.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant que results.has_more vaut 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

Cas d’usage de la Instagram Highlight Items API

  • Inventaire des stories enregistrées : Organisez les ID d’éléments, textes, URL publiques, références de médias et horodatages renvoyés en un inventaire consultable pour des stories à la une connues.
  • Revue des médias d’une story à la une : Inspectez les URL d’images ou de vidéos, miniatures, dimensions, durées, légendes et le contexte de l’auteur pour les éléments actuellement exposés par chaque story à la une.
  • Comparaison entre stories à la une : Regroupez les enregistrements par extra.highlight_id et comparez les types de contenu renvoyés, les dates de publication, les auteurs et les indicateurs visibles entre des stories à la une choisies.

Conseils d’expert pour la Instagram Highlight Items API

  • Si les ID sont inconnus, appelez d’abord instagram/story-highlights par nom d’utilisateur et reprenez extra.highlight_id des résultats réussis ; cet endpoint ne découvre pas les ID à partir des noms d’utilisateur.
  • Supprimez les ID en double avant l’envoi, car le collecteur effectue une recherche indépendante pour chaque valeur fournie.
  • N’ajoutez pas results_limit : chaque ID de story à la une donne les éléments disponibles dans sa réponse unique en amont.
  • Utilisez resource pour distinguer highlight-items de story-highlights, car les deux familles d’enregistrements normalisés utilisent le type story.
  • Traitez le texte, les champs de l’auteur, les indicateurs, les médias, les URL et les horodatages comme facultatifs, et acceptez qu’un élément de story indisponible ou supprimé ne produise aucun enregistrement.
  • Ne suivez results.next_cursor que pour lire d’autres enregistrements de tâche déjà stockés ; il ne poursuit pas la collecte depuis Instagram.

En complément de la Instagram Highlight Items API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.

  • Instagram Posts API — Collectez les publications publiques, médias, hashtags, mentions, horodatages et l’engagement par nom d’utilisateur.
  • Instagram Reels API — Collectez par nom d’utilisateur les Reels publics, médias, audio, hashtags, mentions et l’engagement.
  • Instagram Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, liens, indicateurs de compte, catégories et nombres visibles.
  • Instagram Tagged Posts API — Collectez les publications publiques qui identifient des profils donnés, avec auteurs, médias, mentions, contexte des comptes identifiés et engagement.
  • Instagram Transcript API — Extrayez le texte de transcription, la langue, le format, les URL sources et les shortcodes à partir d’URL de publications ou de Reels publics.
  • Instagram Story Highlights API — Listez les stories à la une publiques d’un nom d’utilisateur avec titres, contexte du propriétaire, nombre de médias et ID de story à la une réutilisables.

Explorer d’autres plateformes

Combinez les données Instagram avec les données publiques d’autres plateformes sociales prises en charge.

Instagram Highlight Items API — FAQ

Instagram Highlight Items API est une interface programmatique qui récupère les éléments de story publics d’ID de stories à la une Instagram numériques connus. Elle renvoie l’identité normalisée de l’élément, le texte, les auteurs, les indicateurs visibles, les métadonnées de médias, les horodatages et le contexte de la story à la une source.

Utilisez un ID de story à la une connu et actuel, ou collectez d’abord les Story Highlights par nom d’utilisateur. Les résultats réussis d’instagram/story-highlights exposent l’identifiant source dans extra.highlight_id lorsqu’il est disponible ; cet endpoint n’accepte pas de noms d’utilisateur.

Un élément normalisé peut contenir l’ID, l’URL, le texte, l’ID de l’auteur, son nom d’utilisateur et son nom, les indicateurs visibles, les métadonnées d’image ou de vidéo, created_at, collected_at et extra.highlight_id. La disponibilité des champs suit la réponse publique en amont.

Aucun results_limit n’est accepté, et le collecteur effectue une requête en amont par ID de story à la une. L’endpoint de résultats de la tâche peut néanmoins paginer les enregistrements sauvegardés avec limit et results.next_cursor.

Une story à la une peut ne contenir aucun enregistrement actuellement exposé, ou ses éléments peuvent avoir été supprimés, restreints, rendus privés ou devenus indisponibles. La tâche ne sauvegarde que les enregistrements présents dans la réponse publique actuelle.

Chaque enregistrement normalisé renvoyé coûte 0,5 crédit, sans frais de base. L’estimation retient 20 enregistrements par ID de story à la une envoyé ; la consommation finale suit les enregistrements effectivement renvoyés.