IG-Nutzer*innen – Business Discovery

Ermöglicht es dir, Daten zu anderen Instagram Business- oder Creator-IG-Nutzer*innen abzurufen.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{ig-user-id}?fields=business_discovery.username({username})

Gibt Daten zu einem*einer anderen Instagram Business- oder Creator-IG-Nutzer*in zurück. Führe diese Anfrage für den*die Instagram Business- oder Creator-IG-Nutzer*in durch, der*die die Abfrage stellt, und ermittle das Zielunternehmen mit dem Parameter username.

Einschränkungen

Daten zu Instagram Business-IG-Nutzer*innen mit Altersbeschränkung werden nicht zurückgegeben.

Abfrage-String-Parameter

{username} (erforderlich) – Der Benutzer*innenname des*der Instagram Business- oder Creator-IG-Nutzer*in, zu dem*der du Daten abrufen möchtest.

Berechtigungen

Ein Nutzer*innen-Zugriffsschlüssel von Facebook mit den folgenden Berechtigungen:

instagram_basic
instagram_manage_insights
pages_read_engagement oder pages_show_list

Wenn der Schlüssel für einen Nutzer gilt, dessen Seitenrolle über den Business Manager erteilt wurde, ist außerdem eine der folgenden Berechtigungen erforderlich:

ads_management
pages_read_engagement
business_management

Felderweiterung

Mit der Felderweiterung kannst du öffentliche Felder zum*zur gewünschten IG-Nutzer*in abrufen. Eine Liste der öffentlichen Felder findest du in der IG-Nutzer*innen-Referenz.

Beispielanfrage mit Felderweiterung

Abrufen von Daten zum*zur Instagram Business-IG-Nutzer*in „Blue Bottle Coffee“ und Anfordern seiner*ihrer Follower*innen und Medienzahlen mit der Felderweiterung

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

Beispielantwort

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Zugreifen auf Edges mit Felderweiterung

Du kannst die Felderweiterung auch verwenden, um auf die /media-Edge für den*die gewünschte*n IG-Nutzer*in zuzugreifen und die Felder und Kennzahlen anzugeben, die für jedes IG-Medien-Objekt zurückgegeben werden sollen. Eine Liste der öffentlichen Felder findest du in der Referenz zum Medien-Node.

Bei Aufrufen mit Version 10.0 und älter bis zum 7. September 2021: Das Feld like_count bei IG-Medien gibt 0 zurück, wenn der Eigentümer des Mediums „Gefällt mir“-Angaben dafür verborgen hat.

Bei Aufrufen mit Version 11.0 und neuer sowie allen Versionen ab dem 7. September 2021: Bei der indirekten Abfrage eines IG-Medien-Objekts über einen anderen Endpunkt oder eine Felderweiterung wird das Feld like_count bei API-Antworten ausgelassen, wenn der Medien-Eigentümer „Gefällt mir“-Angaben dafür verborgen hat. Die direkte Abfrage des IG-Medien-Objekts (die nur durch den Eigentümer des IG-Medien-Objekts ausgeführt werden kann) gibt die tatsächliche Anzahl der „Gefällt mir“-Angaben zurück, auch wenn „Gefällt mir“-Angaben verborgen sind.

Beispielanfrage mit Edge

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

Beispielantwort mit Edge

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Paginierung

Die /media-Edge unterstützt die Cursor-basierte Paginierung. Bei Zugriff über die Felderweiterung enthält die Antwort daher before- und after-Cursor, wenn die Antwort mehrere Seiten mit Daten umfasst. Im Gegensatz zur standardmäßigen Cursor-basierten Paginierung enthält die Antwort allerdings keine previous- oder next-Felder. Daher musst du mit dem before- bzw. dem after-Cursor manuell previous- und next-Abfrage-Strings erstellen, um dich seitenweise durch den zurückgegebenen Datensatz zu bewegen.

Beispielanfrage

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

Beispielantwort

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.