instagram/
story-highlights

Collectez les conteneurs de stories à la une Instagram publics à partir de noms d’utilisateur, avec titres, identité du propriétaire, médias, nombres d’éléments et ID de highlight réutilisables.

Instagram Story Highlights API

Recherche par nom d’utilisateur
Conteneurs de stories à la une
ID de highlight réutilisables
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 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ètresObligatoireDescription
usernamesObligatoireUn 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.

  1. Préparez un ou plusieurs noms d’utilisateur Instagram publics sous forme d’identifiants, et non d’URL de profil.
  2. Envoyez usernames en POST à /v1/instagram/story-highlights.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

Instagram Story Highlights API — FAQ

Instagram Story Highlights API est une interface programmatique qui liste les conteneurs de stories à la une publics des noms d’utilisateur Instagram envoyés. Elle renvoie des ID de conteneur normalisés, des titres, l’identité du propriétaire, des médias, des nombres publics, des nombres d’éléments et des ID de highlight réutilisables.

Envoyez un tableau non vide d’identifiants de comptes Instagram. Un @ initial est supprimé, mais les URL de profil ne sont pas transformées en noms d’utilisateur ; normalisez et dédoublonnez donc les identifiants avant l’envoi.

Non. Il renvoie les conteneurs ; utilisez une valeur numérique extra.highlight_id présente avec instagram/highlight-items lorsque vous avez besoin des éléments de story d’un conteneur.

Un enregistrement peut contenir l’ID du conteneur, l’URL, le titre, l’ID du propriétaire, son nom d’utilisateur et son nom, les médias exposés directement, les nombres publics courants, created_at, collected_at, extra.highlight_id et extra.media_count.

Aucun results_limit contrôlé par l’appelant ni aucune continuation côté fournisseur n’est implémenté. Chaque nom d’utilisateur est demandé une seule fois, tandis que cursor et limit sur l’endpoint de tâche ne paginent que les enregistrements normalisés déjà sauvegardés.

Un profil public peut n’avoir aucune story à la une enregistrée, ou le compte peut être privé, indisponible ou restreint. Une tâche succeeded avec un tableau items vide est une issue valide sans résultat.

La facturation est de 0,5 crédit par highlight normalisé enregistré, sans frais de base. Les estimations reposent sur 20 résultats par nom d’utilisateur envoyé, tandis que la consommation finale suit les enregistrements réellement sauvegardés.