Identifier des personnes et ajouter un lieu à une publication Instagram via l'API
L'API Instagram identifie des personnes avec user_tags et ajoute un lieu avec location_id, deux paramètres définis sur le container média avant sa publication. user_tags liste des noms d'utilisateur publics, avec des coordonnées x et y comprises entre 0.0 et 1.0, obligatoires sur les images ; Meta le décrit pour les images, les vidéos et les Stories. location_id prend l'ID d'une Page disposant de données de localisation, à trouver via la Pages Search API.
easyCoexistence publie des photos, des carrousels, des Reels et des Stories avec publish_instagram_post depuis Claude, ChatGPT ou votre propre code.
Plage de valeurs des coordonnées x et y dans user_tags, mesurées depuis les bords gauche et haut de l'image.
Cas où user_tags exige x et y : ils sont facultatifs sur les Stories, et ne concernent que les images et les Stories.
location_id n'est pas pris en charge sur les images ou vidéos d'un carrousel, selon la référence média de Meta.
La valeur config_issue lorsqu'un média est publié sans ses mentions, que Meta qualifie de succès partiel.
Moment où Meta a ouvert la mention de lieux et de comptes Instagram publics dans les photos publiées par API, d'abord aux partenaires bêta.
Comment identifier des personnes dans une publication ?
Ajoutez user_tags au container. C'est un tableau d'objets, chacun avec le nom d'utilisateur d'un compte Instagram public et, sur une image, x et y : des flottants de 0.0 à 1.0 indiquant la distance de la mention par rapport aux bords gauche et haut. Un lieu va dans location_id dans le même appel, puis le container est publié avec media_publish comme d'habitude.
POST /<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/team.jpg",
"caption": "<CAPTION>",
"user_tags": [
{ "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
],
"location_id": "<PAGE_ID>"
}Quelles publications acceptent les mentions et un lieu ?
La référence média de Meta décrit user_tags pour les images, les vidéos et les Stories, x et y ne s'appliquant qu'aux images et aux Stories, et liste les paramètres acceptés par chaque container. Sur un carrousel, le lieu se place sur le container du carrousel, car location_id n'est pas pris en charge sur les images ou vidéos qu'il contient :
Comment trouver un location_id ?
Recherchez une Page. location_id est l'ID d'une Page associée à un lieu. La référence de Meta renvoie à la Pages Search API, GET /pages/search avec q et fields=id,name,location, puis à la vérification que la Page choisie dispose de données de localisation. Une Page sans ces données échoue avec INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. La recherche s'effectue sur la Graph API de Meta avec le token de votre propre application Meta : un token utilisateur ou, pour les informations publiques d'une Page, un token d'application avec la fonctionnalité Page Public Metadata Access.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Que se passe-t-il si une mention ne s'attache pas ?
La publication peut tout de même être mise en ligne. media_publish renvoie alors config_issue avec la valeur USER_TAGGING_FAILURE, signifiant que le média a été publié sans ses mentions. Meta qualifie cela de succès partiel et demande aux applications de le traiter comme un signal de rapprochement plutôt que comme une erreur, puisque l'ID du média est valide ; republier créerait une seconde publication.
Les mentions fonctionnent-elles avec Instagram Login ?
La référence média de Meta liste user_tags et location_id pour la création de container, sans les lier à une connexion particulière. Sa page sur l'API Instagram avec Instagram Login indique toutefois que cette configuration ne peut accéder ni aux publicités ni aux mentions, sans préciser de quelles mentions il s'agit. Avant de construire sur l'un de ces paramètres avec Instagram Login, publiez une publication test et vérifiez la réponse ainsi que la publication elle-même.
Comment identifier des personnes via easyCoexistence ?
Pas encore. publish_instagram_post crée lui-même le container et ne prend ni user_tags ni location_id, et les tokens Instagram ne sont pas remis pour un appel de votre propre code. Publiez la publication avec publish_instagram_post, puis ajoutez les mentions et le lieu dans l'application Instagram, depuis l'option Modifier de la publication.
Erreurs courantes
- Omettre x et y sur une mention d'image. Meta les exige sur les images ; seules les Stories les rendent facultatifs.
- Donner des coordonnées en pixels ou en pourcentage. x et y sont des flottants de 0.0 à 1.0, mesurés depuis les bords gauche et haut.
- Définir location_id sur les éléments d'un carrousel. Meta ne le prend pas en charge sur les images ou vidéos d'un carrousel.
- Mentionner un compte privé. user_tags n'accepte que les noms d'utilisateur de comptes Instagram publics.
Cet outil ne prend ni user_tags ni location_id : les personnes et les lieux se marquent donc dans l'application Instagram, depuis l'option Modifier de la publication. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Peut-on identifier un compte Instagram privé via l'API ?
Non. La référence média de Meta indique que user_tags n'accepte que les noms d'utilisateur de comptes Instagram publics, donc un compte privé ne peut pas être identifié de cette façon.
Combien de personnes peut-on identifier dans une publication ?
La référence de Meta pour user_tags ne donne aucun maximum. La limite de 20 qu'elle mentionne concerne les @ mentions dans une légende.
Peut-on ajouter un lieu à une Story via l'API ?
Non. La syntaxe de Meta pour un container de Story liste user_tags, mais pas location_id.
Peut-on identifier un produit au lieu d'une personne ?
Les identifications de produits sont une fonctionnalité distincte. La vue d'ensemble de Meta la indique comme prise en charge avec Facebook Login et Unified Login, et non avec Instagram Login.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le