Instagram-Plattform

Business Discovery

Du kannst die Instagram Graph API verwenden, um grundlegende Metadaten und Kennzahlen zu anderen Instagram Business- und Creator-Konten abzurufen.

Einschränkungen

Es werden keine Daten zu Instagram Business-Konten zurückgegeben, für die eine Altersbeschränkung vorgesehen ist.

Endpunkte

Die API besteht aus den folgenden Endpunkten. Informationen zu Anforderungen an Parameter und Berechtigungen findest du in der Referenzdokumentation zum Endpunkt.

Beispiele

Abrufen der Anzahl an Abonnenten und Medien eines Kontos

An dieser Beispielanfrage siehst du, wie du die Anzahl an Abonnenten und veröffentlichten Medienobjekten für das Instagram Business-Konto Blue Bottle Coffee abrufen kannst. Beachte, dass Business Discovery-Abfragen für die Instagram Business- oder Creator-Konto-ID (in diesem Fall 17841405309211844) und nicht für den Benutzernamen des Instagram Business- oder Creator-Kontos durchgeführt werden, für das du Daten abrufen möchtest (in diesem Beispiel bluebottle).

Beispielanfrage

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

Beispielantwort

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

Abrufen von Medien

Da du verschachtelte Anforderungen erstellen kannst, indem du über den Parameter fields eine Edge angibst, kannst du die media-Edge des angesprochenen Business- oder Creator-Kontos anfordern, um dessen veröffentlichte Medienobjekte zu erhalten:

Beispielanfrage

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={access-token}"

Beispielantwort

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

Abrufen grundlegender Kennzahlen für Medien

Du kannst sowohl verschachtelte Anforderungen als auch Felderweiterung verwenden, um öffentliche Felder für die Medienobjekte von Business- oder Creator-Konten abzurufen. Beachte, dass du dadurch keine Berechtigung erhältst, direkt auf Medienobjekte zuzugreifen. Wenn du eine GET-Aktion für ein zurückgegebenes IG-Medium ausführst, schlägt diese aufgrund unzureichender Berechtigungen fehl.

Hier erfährst du beispielsweise, wie du die Anzahl der Kommentare und „Gefällt mir“-Angaben für jedes der von Blue Bottle Coffee veröffentlichten Medienobjekte abrufst:

Beispielanfrage

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={access-token}"

Beispielantwort

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}