Instagram Story Highlights
Les stories à la une Instagram sont des collections de stories enregistrées sur des profils publics, rangées sous des titres avec le contexte du propriétaire, un média de couverture et un nombre d’éléments. Ces enregistrements de conteneurs servent à inventorier les catégories d’un profil, à comparer des comptes entre eux et à choisir les stories à la une dont on veut examiner le détail.
Fonctionnalités de la Instagram Story Highlights API
- Inventaire multi-profilsEnvoyez un ou plusieurs noms d’utilisateur Instagram pour lister les conteneurs de stories à la une publics exposés par chaque compte, en gardant le contexte du propriétaire.
- Identité et contexte du conteneurRecevez des ID de highlight normalisés, des titres, des URL, l’identité du propriétaire, les médias exposés directement, des horodatages, des nombres publics et les totaux d’éléments déclarés.
- Passage au niveau des élémentsServez-vous de extra.highlight_id pour conserver le lien avec le conteneur et transmettre les ID numériques de highlight aux workflows de collecte par élément.
Paramètres de la Instagram Story Highlights API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Un ou plusieurs noms d’utilisateur Instagram publics, sous forme d’identifiants non vides ; un @ initial est accepté et supprimé avant la collecte. |
Comment utiliser la Instagram Story Highlights API
Envoyez des noms d’utilisateur de comptes publics sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les conteneurs normalisés grâce à la pagination des résultats par curseur.
- Préparez un ou plusieurs noms d’utilisateur Instagram publics sous forme d’identifiants, et non d’URL de profil.
- Envoyez usernames en POST à /v1/instagram/story-highlights.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez data.results.items et suivez results.next_cursor tant que results.has_more vaut 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 trueCas d’usage de la Instagram Story Highlights API
- Inventaire des catégories d’un profil public : Organisez titres, identité du propriétaire, URL et nombres de médias en un inventaire des catégories de stories enregistrées visibles sur un profil.
- Comparaison entre comptes : Comparez les titres de conteneurs, les totaux d’éléments déclarés, les références de médias et les horodatages disponibles pour les noms d’utilisateur publics envoyés.
- Sélection de collections de stories : Associez extra.highlight_id aux titres et à media_count pour choisir les conteneurs numériques à récupérer ensuite élément par élément.
Conseils d’expert pour la Instagram Story Highlights API
- Normalisez les identifiants avant l’envoi en supprimant les @ initiaux et en dédoublonnant les noms d’utilisateur obtenus, car les URL de profil ne sont pas converties en identifiants.
- Comptez sur une seule requête de liste par nom d’utilisateur, sans results_limit ni continuation côté fournisseur : la liste de conteneurs disponible détermine les enregistrements collectés pour chaque compte.
- N’utilisez next_cursor du résultat de la tâche que pour parcourir les enregistrements normalisés déjà sauvegardés ; il ne demande pas une autre page de highlights à Instagram.
- Ne transmettez à instagram/highlight-items que des valeurs numériques extra.highlight_id présentes, lorsque vous avez besoin des frames de story individuelles.
- Considérez un résultat vide comme une issue possible : aucun highlight ou profil indisponible. Ne présumez rien des médias, indicateurs, URL et horodatages facultatifs.
API associées
En complément de la Instagram Story Highlights 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 Highlight Items API — Récupérez les éléments de stories publiques enregistrés à partir d’ID de stories à la une connus, avec texte, identité de l’auteur, médias, horodatages, indicateurs visibles et contexte source.
- Instagram Stories API — Collectez par nom d’utilisateur les stories actuellement en ligne d’un compte public, avec médias, heures de publication et heures d’expiration.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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