InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Personen taggen en een locatie toevoegen aan een Instagram-post via de API

De Instagram API taggt personen met user_tags en voegt een plaats toe met location_id, beide ingesteld op de media-container voordat die wordt gepubliceerd. user_tags bevat openbare gebruikersnamen, met x- en y-coördinaten van 0.0 tot 1.0, die bij afbeeldingen verplicht zijn. Meta beschrijft dit voor afbeeldingen, video's en Stories. location_id neemt het ID van een Pagina met locatiegegevens, gevonden via de Pages Search API.

easyCoexistence publiceert foto's, carrousels, Reels en Stories met publish_instagram_post vanuit Claude, ChatGPT of je eigen code.

0.0 to 1.0

Bereik van de x- en y-coördinaten in user_tags, gemeten vanaf de linker- en bovenrand van de afbeelding.

Images

Waar user_tags x en y vereist; ze zijn optioneel bij Stories en gelden alleen voor afbeeldingen en Stories.

Carousels

location_id wordt niet ondersteund bij de afbeeldingen of video's in een carrousel, zegt Meta's mediareferentie.

USER_TAGGING_FAILURE

De config_issue-waarde wanneer media zonder zijn user_tags wordt gepubliceerd, wat Meta een gedeeltelijk succes noemt.

13 Mar 2018

Wanneer Meta het taggen van locaties en openbare Instagram-gebruikers in via de API gepubliceerde foto's opende, eerst voor bètapartners.

Hoe tag je personen in een post?

Voeg user_tags toe aan de container. Het is een array van objecten, elk met de gebruikersnaam van een openbaar Instagram-account en, bij een afbeelding, x en y: floats van 0.0 tot 1.0 die de afstand van de tag tot de linker- en bovenrand aangeven. Een locatie gaat in dezelfde aanroep in location_id, waarna de container gewoon met media_publish wordt gepubliceerd.

An image container with a user tag and a location
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>"
}

Welke posts ondersteunen user_tags en een locatie?

Meta's mediareferentie beschrijft user_tags voor afbeeldingen, video's en Stories, waarbij x en y alleen gelden voor afbeeldingen en Stories, en somt de parameters op die elke container accepteert. Bij een carrousel gaat de locatie op de carrouselcontainer, want location_id wordt niet ondersteund bij de afbeeldingen of video's erin:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo location_id

Hoe vind je een location_id?

Zoek een Pagina. location_id is het ID van een Pagina die aan een locatie is gekoppeld. Meta's referentie verwijst naar de Pages Search API, GET /pages/search met q en fields=id,name,location, en daarna naar controleren of de gekozen Pagina locatiegegevens heeft. Een Pagina zonder die gegevens faalt met INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. De zoekopdracht loopt via Meta's Graph API met het token van je eigen Meta-app: een gebruikerstoken, of voor openbare Pagina-informatie een apptoken met de functie Page Public Metadata Access.

Searching for a Page with a location
GET /pages/search
  ?q=<PLACE_NAME>
  &fields=id,name,location
  &access_token=<ACCESS_TOKEN>

Wat gebeurt er als een tag niet wordt gekoppeld?

De post kan toch live gaan. media_publish geeft dan config_issue terug met de waarde USER_TAGGING_FAILURE, wat betekent dat de media is gepubliceerd zonder zijn user_tags. Meta noemt dit een gedeeltelijk succes en vraagt apps het als signaal te behandelen om na te kijken, niet als fout, omdat de media-ID geldig is; opnieuw publiceren zou een tweede post maken.

Werken user_tags met Instagram Login?

Meta's mediareferentie noemt user_tags en location_id voor het aanmaken van containers zonder ze aan één login te koppelen. Op zijn pagina over de Instagram API met Instagram Login staat echter dat die opzet geen toegang tot advertenties of taggen heeft, zonder te zeggen welke tagging wordt bedoeld. Test voordat je met Instagram Login op een van beide parameters bouwt: publiceer een testpost en controleer de respons en de post zelf.

Hoe tag je personen via easyCoexistence?

Dat kan nog niet. publish_instagram_post maakt de container zelf aan en neemt geen user_tags of location_id, en Instagram-tokens worden niet uitgegeven voor een eigen aanroep. Publiceer de post met publish_instagram_post en voeg de tags en de locatie daarna toe in de Instagram-app, via de optie Bewerken van de post.

Veelgemaakte fouten

  • x en y weglaten bij een tag op een afbeelding. Meta vereist ze bij afbeeldingen; alleen bij Stories zijn ze optioneel.
  • Coördinaten in pixels of procenten opgeven. x en y zijn floats van 0.0 tot 1.0, gemeten vanaf de linker- en bovenrand.
  • location_id instellen op carrouselitems. Meta ondersteunt dat niet bij de afbeeldingen of video's in een carrousel.
  • Een privéaccount taggen. user_tags accepteert alleen de gebruikersnamen van openbare Instagram-accounts.
Dit doen met EasyCoexistence

De tool neemt geen user_tags of location_id, dus personen en plaatsen worden getagd in de Instagram-app, via de optie Bewerken van de post. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.

Veelgestelde vragen

Kan ik via de API een privé-Instagram-account taggen?

Nee. Meta's mediareferentie zegt dat user_tags alleen gebruikersnamen van openbare Instagram-accounts accepteert, dus een privéaccount kan zo niet worden getagd.

Hoeveel personen kun je in één post taggen?

Meta's referentie voor user_tags noemt geen maximum. De limiet van 20 die Meta noemt, geldt voor @-tags in een bijschrift.

Kan ik via de API een locatie aan een Story toevoegen?

Nee. De syntaxis van Meta voor een Story-container noemt user_tags, maar niet location_id.

Kan ik een product taggen in plaats van een persoon?

Producttags zijn een aparte functie, die Meta's overzicht ondersteund noemt met Facebook Login en Unified Login, niet met Instagram Login.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op