Business Discovery

Du kannst die Instagram API mit Facebook Login verwenden, um grundlegende Metadaten und Kennzahlen zu anderen professionellen Instagram-Konten abzurufen.

Einschränkungen

Es werden keine Daten zu professionellen Instagram-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.

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Beispiele

Anzahl der Abonnenten und Medien abrufen

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

Beispielanfrage

Für Lesbarkeit formatiert.

curl -i -X GET \
 "https://graph.facebook.com/v20.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Beispielantwort

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram user ID
  },
  "id": "17841405309211844"  // Your app user's Instagram user ID
}

Medien abrufen

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

Beispielanfrage

Für Lesbarkeit formatiert.

curl -i -X GET \
 "https://graph.facebook.com/v20.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_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"
}

Grundlegende Kennzahlen für Medien abrufen

Du kannst sowohl verschachtelte Anforderungen als auch Felderweiterung verwenden, um öffentliche Felder für die Medienobjekte von Business- oder Creator*innen-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

Für Lesbarkeit formatiert.

curl -i -X GET \
 "https://graph.facebook.com/v20.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_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"
}