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ètres | Obligatoire | Description |
|---|---|---|
highlight_ids | Obligatoire | Un 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.
- 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é.
- Envoyez highlight_ids en POST à /v1/instagram/highlight-items.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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 trueCas 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.
API associées
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.
- 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