> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram API

> Optionen zum Posten mit der Instagram API

<Info>
  Wenn Sie Probleme beim Verbinden von Instagram haben, siehe den [Leitfaden zur
  Fehlerbehebung](/help-center/technical-support/facebook_or_instagram_linking_issues).
</Info>

<Info>
  Wenn Ihre Medien auf einem Server oder CDN gehostet werden, den Sie kontrollieren, stellen Sie sicher, dass der Publishing-Crawler von Meta
  sie abrufen kann. Siehe [Meta Media Crawler blockiert](/help-center/technical-support/meta_media_crawler_blocked),
  falls Sie den Ayrshare-Fehlercode 440 („social network could not download media from this URL") oder den Fehlercode 138 mit „Restricted by robots.txt" in den Details sehen.
</Info>

<div class="video-container">
  <iframe width="380" height="200" src="https://www.youtube.com/embed/3F7mbVN0qrw" title="Posting to Instagram API" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" />
</div>

Die Instagram API hat die folgenden Anforderungen und Einschränkungen.

<ul class="custom-bullets">
  <li>
    Business- oder Creator-Instagram-Konto, das mit einer Facebook-Page verbunden ist – [siehe
    hier](/dashboard/connect-social-accounts/instagram).
  </li>

  <li>Innerhalb von 24 Stunden sind nur 50 Instagram-Beiträge erlaubt. Siehe unten zu `usedQuota`.</li>

  <li>
    Der `post`-Text darf bis zu *5 Hashtags* (z. B. #wildtimes) und *3 Benutzernamen-Erwähnungen*
    (z. B. @natgeo) enthalten.
  </li>

  <li>Erwähnte Instagram-Nutzer (@mention) erhalten eine Benachrichtigung.</li>
  <li>Maximal 2.200 Beitragszeichen.</li>

  <li>
    Multi-Bild-/-Videobeiträge werden unterstützt und als Karussell gesendet. Sie können bis zu 10 Videos und
    Bilder senden.
  </li>

  <li>
    Instagram unterstützt kein Löschen über die API. Löschungen müssen manuell in der Instagram-App erfolgen.
  </li>

  <li>
    Wenn Ihr Reel-Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter `isVideo`.
    Weitere Informationen finden Sie unter [/post-Endpunkt](/apis/post/post).
  </li>

  <li>
    Instagram unterstützt auch das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten,
    senden Sie einen leeren String `post: ""`.
  </li>

  <li>Weitere Informationen finden Sie unter [Instagram-Medienrichtlinien](/media-guidelines/instagram) und [Instagram-Autorisierung](/dashboard/connect-social-accounts/instagram).</li>
</ul>

## Posten auf Instagram

JSON für einen einfachen Beitrag mit Bild und Hashtags auf Instagram:

```json Instagram Post theme={"system"}
{
  "post": "The best IG ever #best #awesome https://www.instagram.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["instagram"]
}
```

Hashtags sind in Instagram-Beiträgen anklickbar, Links jedoch nicht.

<Note>
  Das Seitenverhältnis von Bildern und Videos sowie die Videolänge sind für ein erfolgreiches Posten auf Instagram sehr wichtig. Werden die Anforderungen nicht erfüllt, wird der Beitrag abgelehnt.

  [Siehe den Instagram-Abschnitt der Bild- und Video-Richtlinien](/media-guidelines/instagram).
</Note>

## Instagram Business- oder Creator-Konto

Ihr Instagram-Konto muss ein Business- oder Creator-Konto sein und mit einer Facebook-Page verbunden sein. Die Einrichtung ist kostenlos und einfach.

Ausführliche Anweisungen finden Sie hier:

<Card title="Instagram-Verknüpfung" icon="link" href="/dashboard/connect-social-accounts/instagram" horizontal />

## Karussell aus Bildern und Videos

Sie können mehrere Bilder oder Reel-Videos als Karussell auf Instagram posten; insgesamt können bis zu 10 Bilder oder Videos kombiniert in einem Karussell verwendet werden.
Fügen Sie einfach weitere Bilder oder Videos zum Array `mediaUrls` hinzu, und das Karussell wird automatisch erstellt.

```json Instagram Carousel Post theme={"system"}
{
  // Max 10 images or videos
  "mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4"]
}
```

<Note>
  Video-URLs müssen mit einer bekannten Endung wie `mp4` enden. Der Parameter `isVideo` wird für
  Instagram-Karussells nicht unterstützt.
</Note>

## Instagram Reels

Auf Instagram wird ein Videobeitrag als Reel bezeichnet.
Sie können ein Video mit den folgenden optionalen `instagramOptions` an die Instagram Reels API posten.

```json Instagram Reels Options theme={"system"}
{
  "instagramOptions": {
    "shareReelsFeed": true,
    "audioName": "The Weeknd - Blinding Lights",
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg", // if used, thumbNailOffset will be ignored.
    "thumbNailOffset": 30000
  }
}
```

<ul class="custom-bullets">
  <li>
    Details zu den Video-Anforderungen finden Sie unter [Video-Anforderungen der Reels API](/media-guidelines/instagram#reels).
  </li>

  <li>
    `shareReelsFeed`: Boolean, auf `true` gesetzt, um anzuzeigen, dass der Reel *sowohl* im
    **Feed**- als auch im **Reels**-Tab erscheinen *kann*, oder `false`, um anzuzeigen, dass der Reel nur im **Reels**-Tab
    erscheinen *kann*. Dieser Wert ist ein Hinweis an Instagram, wo der Reel angezeigt werden soll; keiner der Werte
    bestimmt jedoch, ob der Reel *tatsächlich* im **Reels**- oder **Feed**-Tab erscheint,
    da der Reel möglicherweise die Voraussetzungen nicht erfüllt oder vom Instagram-Algorithmus nicht ausgewählt wird.
  </li>

  <li>
    `audioName`: String-Name der Audiomusik Ihrer Reels-Medien. Sie können nur einmal umbenennen, entweder
    beim Erstellen eines Reels oder danach über die Audio-Seite. Beispiel: `"The Weeknd - Blinding
            Lights"`.
  </li>

  <li>
    `thumbNail`: String-URL des Reel-Titelbildes (Thumbnail). Details zu
    thumbNail finden Sie [hier](/apis/post/social-networks/instagram#reels-thumbnails).
  </li>

  <li>
    `thumbNailOffset`: Ganzzahliger Offset in Millisekunden für das Thumbnail-Bild. Details zu
    thumbNailOffset finden Sie [hier](/apis/post/social-networks/instagram#reels-thumbnails).
  </li>
</ul>

Siehe die [Video-Anforderungen der Reels API](/media-guidelines/instagram#reels) oder ein [Beispiel zur Nutzung der Instagram Reels API](https://www.ayrshare.com/blog/instagram-reels-api-how-to-post-videos-to-reels-using-a-social-media-api/).

Sie können außerdem eine [Reels-Cover-URL](/apis/post/social-networks/instagram#reels-thumbnails) und [Standort- & Nutzer-Tags](/apis/post/social-networks/instagram#user-tags-and-locations) festlegen.

## Trial Reels

Ein Trial Reel ist ein Reel, das beim erstmaligen Posten nur an Nicht-Follower veröffentlicht wird. So können Sie testen, wie ein Reel bei einem neuen Publikum abschneidet, bevor er Ihre bestehenden Follower erreicht. Setzen Sie `trialParams.graduationStrategy` in `instagramOptions`, um einen Reel als Trial zu veröffentlichen.

```json Instagram Trial Reel theme={"system"}
{
  "post": "Testing this with a fresh audience first",
  "mediaUrls": ["https://img.ayrshare.com/random/portrait1.mp4"],
  "platforms": ["instagram"],
  "instagramOptions": {
    "trialParams": {
      "graduationStrategy": "MANUAL"
    }
  }
}
```

`graduationStrategy` steuert, wie ein Trial Reel später „graduiert" – d. h. auch für Ihre Follower sichtbar wird. Es ist erforderlich, wenn `trialParams` angegeben ist, und muss einer der folgenden Werte sein:

<ul class="custom-bullets">
  <li>
    <code>"MANUAL"</code> — Der Beitrag bleibt ein Trial Reel, bis Sie ihn manuell in der
    Instagram-App graduieren.
  </li>

  <li>
    <code>"SS\_PERFORMANCE"</code> — Meta graduiert den Reel automatisch anhand der frühen Performance
    bei Nicht-Followern.
  </li>
</ul>

<Note>
  Die Graduierung selbst (also das Sichtbarmachen eines veröffentlichten Trial Reels für Follower) wird derzeit
  von der Meta-API nicht bereitgestellt und muss manuell in der Instagram-App durchgeführt werden. Ayrshare wird einen
  Graduierungs-Endpunkt hinzufügen, sobald Meta einen bereitstellt.
</Note>

### Einschränkungen für Trial Reels

Die Trial-Reel-Anfrage wird am Ayrshare-Rand – noch vor einem Meta-Aufruf – abgelehnt, wenn eine der folgenden Bedingungen nicht erfüllt ist:

<ul class="custom-bullets">
  <li>Genau eine Medien-URL, die auf <code>.mp4</code> oder <code>.mov</code> endet (Groß-/Kleinschreibung wird ignoriert). Karussells werden nicht unterstützt.</li>
  <li><code>instagramOptions.stories</code> darf nicht <code>true</code> sein. Stories können keine Trial Reels sein.</li>
  <li><code>graduationStrategy</code> muss vorhanden und exakt <code>"MANUAL"</code> oder <code>"SS\_PERFORMANCE"</code> sein (Groß-/Kleinschreibung beachten).</li>
</ul>

Fehler geben einen von drei Ayrshare-Fehlercodes zurück – siehe [Instagram-Trial-Reel-Fehler](/errors/errors-ayrshare#instagram-specific-error-codes) (<code>447</code>, <code>448</code>, <code>449</code>) für die vollständigen Payloads.

## Instagram Stories

Sie können ein einzelnes Bild oder Video als Instagram-Story mit den folgenden `instagramOptions` posten. Instagram-Stories verschwinden nach 24 Stunden.

```json Stories Post theme={"system"}
{
  "post": "The description of the video",
  "mediaUrls": ["https://img.ayrshare.com/random/portrait1.mp4"],
  "instagramOptions": {
    "stories": true
  }
}
```

Siehe die [Anforderungen der Stories API](/media-guidelines/instagram#stories).

<ul class="custom-bullets">
  <li>
    Instagram-Stories unterstützen keinen Beitragstext – jeglicher Text im Feld `post`, einschließlich
    Erwähnungen, wird ignoriert.
  </li>

  <li>Stories laufen nach 24 Stunden ab.</li>

  <li>
    Instagram unterstützt das Veröffentlichen von Stories derzeit nur für Instagram-Business-Konten und nicht
    für Creator-Konten.
  </li>

  <li>Instagram-Stories unterstützen keine Kollaborationen.</li>
  <li>Das Veröffentlichen von Stickern (z. B. Link, Umfrage, Standort) wird von Instagram nicht unterstützt.</li>
</ul>

## Reels-Thumbnails

Sie können einen Frame des Reels als Thumbnail auswählen oder ein eigenes Titelbild (Thumbnail) von einer externen URL verwenden.

```json Instagram Thumbnail theme={"system"}
{
  "instagramOptions": {
    // milliseconds
    "thumbNailOffset": 30000,
    // If both thumbNail and thumbNailOffset includes, thumbNail will be used.
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}
```

Der Offset ist die Position in Millisekunden des Thumbnail-Frames des Reel-Videos. Der Standardwert ist `0`, was dem ersten Frame des Reels entspricht.

Wenn Sie sowohl eine Thumbnail-URL als auch einen Thumbnail-Offset angeben, wird der Thumbnail-Offset ignoriert.

Das Reel-Thumbnail muss den [Reels-Thumbnail-Anforderungen](/media-guidelines/instagram#reels-thumbnails) entsprechen.
Signierte URLs mit Weiterleitungen sind nicht garantiert mit Cover-URLs kompatibel.
Wir empfehlen eine nicht signierte URL oder die Verwendung des [/media-Endpunkts](/apis/media/overview).

## Alternativtext

Fügen Sie einem Bild einen Instagram-Alternativtext (auch Alt-Text genannt) hinzu.
Der Instagram-Alt-Text ist eine Barrierefreiheitsfunktion für zusätzliche Nutzerinformationen und Screenreader.

<ul class="custom-bullets">
  <li>Alt-Text unterstützt bis zu 1.000 Zeichen pro Bild.</li>
  <li>Instagram unterstützt keinen Alt-Text für Reels oder Stories.</li>
</ul>

Verwenden Sie `altText` im Objekt `instagramOptions`.

```json Instagram Alt Text theme={"system"}
{
  "instagramOptions": {
    // Array of Alt Texts
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}
```

Jeder Alt-Text muss einem Bild oder Video im Array `mediaUrls` entsprechen.
Der Alt-Text wird in der angegebenen Reihenfolge auf jedes Bild angewendet.

## Nutzer-Tags & Standorte

<Info>
  Der Instagram-Nutzer wird benachrichtigt, wenn Sie seinen Benutzernamen in einem Beitrag verwenden. Achten Sie darauf,
  Nutzer nicht zu spammen oder wiederholt mit ihrem Benutzernamen zu posten. Andernfalls kann Instagram Ihr Konto
  sperren oder deaktivieren.
</Info>

Ein Bild oder ein Reel kann mit Instagram-Nutzern getaggt werden, und ein Bild, Video oder Reel kann mit einem Standort mithilfe des Parameters `instagramOptions` getaggt werden.

### Standort

Ein Standort wird über eine `locationId` angegeben, also eine Facebook-Page-ID oder ein Facebook-Page-Name. Zum Beispiel ist die Facebook-Page-ID des [Guggenheim Museums](https://www.facebook.com/guggenheimmuseum) `7640348500` oder der Facebook-Page-Name `"@guggenheimmuseum"`. Pages müssen mit einem physischen Standort verknüpft sein.

```json Instagram Location theme={"system"}
// Using the Facebook Page Id - must be associated with a location
{
    "instagramOptions": {
        "locationId": 7640348500 // Guggenheim Museum Page Id
    }
}

// Using the Facebook Page name - must be associated with a location
{
    "instagramOptions": {
        "locationId": "@guggenheimmuseum" // Guggenheim Museum Page name. Must begin with @
    }
}
```

Sie können die `locationId` (Page ID) mit dem [Brand-Endpunkt](/apis/brand/overview) nachschlagen. Beachten Sie, dass die Page einen Standort hinterlegt haben muss, sonst gibt die locationId einen Fehler zurück.

<Note>Wird für Bilder oder Videos in Karussells nicht unterstützt.</Note>

### Nutzer-Tags

Mit Instagram-Tags können Sie andere Instagram-Nutzer in Ihrem Beitrag markieren.
Nutzer werden über `userTags` angegeben, das ein Array von Objekten mit einem Instagram-Benutzernamen und x/y-Koordinaten (nur bei Bildern) enthält. Nutzer-Tags können für einzelne Bilder oder Reels hinzugefügt werden, jedoch nicht für normale Videos, mehrere Bilder oder Stories.

<ul class="custom-bullets">
  <li>Benutzernamen müssen öffentliche Instagram-Konten sein. Fügen Sie das @ des Nutzer-Handles nicht hinzu.</li>

  <li>
    `x`- und `y`-Werte müssen `float`-Zahlen sein, die von der oberen linken Ecke des Bildes ausgehen, mit einem
    Bereich von `0.0`–`1.0`. Nur für Einzelbilder. Verwenden Sie sie nicht bei Reels, sonst tritt ein Fehler auf.
  </li>
</ul>

```json Instagram User Tags theme={"system"}
{
  "instagramOptions": {
    "userTags": [
      {
        "username": "ayrshare", // Required: Instagram username
        "x": 0.5, // Required for Images, cannot be used with Reels
        "y": 1.0 // Required for Images, cannot be used with Reels
      },
      {
        "username": "johnboy", // Required: Instagram username
        "x": 0.1, // Required for Images, cannot be used with Reels
        "y": 0.9 // Required for Images, cannot be used with Reels
      }
    ]
  }
}
```

## Instagram-Erwähnungen

Erwähnen Sie einen anderen Instagram-Handle, indem Sie @handle im Beitragstext hinzufügen.

Zum Beispiel können Sie den @ayrshare-Handle im Beitragstext erwähnen:

```json Instagram Mentions theme={"system"}
{
  "post": "The best social media API @Ayrshare ever!", // empty string is allowed
  "mediaUrls": ["https://images.com/image.jpg"],
  "platforms": ["instagram"]
}
```

<Warning>
  Der erwähnte Nutzer (`@mentioned`) wird über die Erwähnung benachrichtigt. Bitte lesen Sie die [wichtigen
  Regeln](/testing/post-verification#mentions) zu Erwähnungen.
</Warning>

## Kollaboration

Instagram-Kollaboration ermöglicht es Ihnen, Inhalte gemeinsam mit anderen Instagram-Konten zu verfassen, indem Sie [andere als Kollaboratoren taggen](https://www.facebook.com/help/instagram/291200585956732).
So können Sie andere Instagram-Nutzer als Creator Ihres Beitrags markieren.
Wenn sie getaggt werden, erhalten diese Nutzer in der mobilen App eine Einladung zur Kollaboration.
Wenn sie annehmen, erscheint der Beitrag auch in ihrem Feed und ist für ihre Follower sichtbar, wodurch sich die Reichweite und das Engagement des Beitrags erhöhen.

### Kollaboratoren

Der öffentliche Originalautor kann ein anderes öffentliches Konto als Instagram-Kollaborator taggen.
Das andere Konto erhält eine Nachricht und kann die Anfrage annehmen oder ablehnen.
Wenn das andere Konto annimmt, wird der Beitrag auch in dessen Profil angezeigt und im Instagram-Feed an dessen Follower verteilt.
Der Header des Beitrags weist den Inhalt beiden Konten zu.

Sie können Kollaboratoren zu einem Reel, Bild oder Karussell hinzufügen.

Das Taggen eines privaten Kollaborators ist über die Instagram API nicht erlaubt. Während
diese Funktionalität in der Instagram-App existiert, sind Plattformen und ihre APIs
oft nicht auf [demselben Funktionsstand](/help-center/product/are_social_networks_native_apps_and_the_apis_at_parity).

<Warning>Instagram-Stories unterstützen keine Kollaboratoren.</Warning>

<Warning>
  <ul class="custom-bullets">
    <li>**Laden Sie nur Kollaboratoren ein, von denen Sie erwarten, dass sie Ihre Einladung `accept`**.</li>

    <li>
      Wenn der [Kollaborator
      antwortet](/apis/post/social-networks/instagram#get-collaborator-request-status) mit einer
      `declined` Kollaborationsanfrage, **laden Sie ihn nicht erneut ein**, bevor Sie mit ihm gesprochen und den Grund für die Ablehnung
      verstanden haben.
    </li>

    <li>
      Wiederholte Ablehnungen durch denselben Nutzer oder mehrere Nutzer bringen Ihr Instagram- und Ayrshare-Konto
      in Gefahr, gesperrt zu werden.
    </li>

    <li>Der Originalautor kann jederzeit einen Kollaborator hinzufügen oder entfernen.</li>
  </ul>
</Warning>

Laden Sie *bis zu drei* Kollaboratoren mit einem Array öffentlicher Instagram-Benutzernamen ein.

```json Instagram Collaborators theme={"system"}
{
  "instagramOptions": {
    "collaborators": ["ayrshare", "therock", "taylorswift"] // Up to three
  }
}
```

Diese drei Kollaboratoren erhalten in ihrer Instagram-Mobile-App eine Nachrichteneinladung und können die Einladung annehmen oder ablehnen; anschließend können Sie den [Anfragestatus des eingeladenen Nutzers prüfen](/apis/post/social-networks/instagram#get-collaborator-request-status).
Laden Sie nur Kollaboratoren ein, von denen Sie wissen, dass sie Ihre Anfrage annehmen, andernfalls kann Ihr Instagram-Konto negativ beeinflusst werden.

<Warning>
  Hinweis zu eingeladenen Kollaboratoren: Mit wenigen Ausnahmen können Daten zu oder über gemeinsam verfasste Medien
  über die API nur von dem Nutzer abgerufen werden, der die Medien veröffentlicht hat; Kollaboratoren können
  diese Daten nicht über die API abrufen.
</Warning>

### Anfragestatus eines Kollaborators abrufen

Nachdem Sie einen Instagram-Kollaborator eingeladen haben, können Sie den Status der Anfrage über die [API zum Abrufen des Kollaborator-Anfragestatus](/apis/utils/instagram-get-collaborator) prüfen.

## Automatische Bildskalierung

<Note>Max Pack erforderlich</Note>

Bilder werden mit dem Parameter `autoResize` automatisch auf 1080 × 1080 px skaliert, um mit Instagram zu funktionieren. Beachten Sie: Dies skaliert das Bild für alle enthaltenen Plattformen. Wir empfehlen daher, einen Aufruf für Instagram und einen anderen /post-Aufruf für weitere Plattformen durchzuführen.

```json Instagram Auto Image Resize theme={"system"}
{
  "post": "Let it go!",
  "platforms": ["instagram"],
  "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"],
  "instagramOptions": {
    "autoResize": true, // Max Pack
    "locationId": 7640348500,
    "userTags": [
      {
        "username": "ayrshare",
        "x": 0.5,
        "y": 0.5
      },
      {
        "username": "ayrshare",
        "x": 0.3,
        "y": 0.2
      }
    ]
  }
}
```

## Verbrauchtes Kontingent

Die Instagram-Antwort enthält das aktuelle `usedQuota` für die Anzahl der Instagram-Beiträge, die in einem rollierenden 24-Stunden-Zeitraum getätigt wurden. Instagram erlaubt nur 50 Instagram-Beiträge in einem rollierenden 24-Stunden-Zeitraum.

```json Instagram Used Quota theme={"system"}
{
    "status": "success",
    "errors": [],
    "postIds": [
        {
            "status": "success",
            "id": "17823977408036085",
            "postUrl": "https://www.instagram.com/p/CeBrkQuN1Kv/",
            "usedQuota": 15,
            "platform": "instagram"
        }
    ],
    "id": "l4FaPHSXWJNdmMfm3dIE",
    "refId": "65806e8d9efd78a58c05566a887043329dcdc76b",
    "post": "Luckily for Alice, the little magic bottle had now had its full effect."
}
```

Wenn das Kontingent erreicht ist, wird eine Fehlermeldung zurückgegeben.

## Inhaltsprobleme

Ayrshare enthält einen integrierten Medienschutz, der bestimmte Probleme bei der Medienübermittlung während des Postens erkennen und beheben kann. Wenn ein Beitrag erfolgreich ist, aber ein Inhaltsproblem erkannt und behoben wurde, enthält die Antwort ein optionales `contentIssues`-Objekt. So können Sie Probleme mit Ihrem Medien-Hosting proaktiv identifizieren und beheben.

Das `contentIssues`-Objekt ist nur vorhanden, wenn ein Problem erkannt und behoben wurde – normale erfolgreiche Beiträge enthalten es nicht.

| Feld                    | Typ              | Beschreibung                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `originMediaHostFailed` | boolean          | Das soziale Netzwerk konnte die Medien nicht von der angegebenen URL abrufen. Der automatisierte Medienschutz von Ayrshare hat das Problem behoben und den Beitrag erfolgreich abgeschlossen. Erwägen Sie, Ihre Medien-Hosting-Konfiguration zu überprüfen — siehe [Meta Media Crawler blockiert](/help-center/technical-support/meta_media_crawler_blocked) für häufige Ursachen. |
| `details`               | array of strings | Menschenlesbare Beschreibungen jedes erkannten Problems.                                                                                                                                                                                                                                                                                                                           |

```json Content Issues Response Example theme={"system"}
{
    "status": "success",
    "errors": [],
    "postIds": [
        {
            "status": "success",
            "id": "17878176260289172",
            "postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
            "usedQuota": 12,
            "platform": "instagram",
            "contentIssues": {
                "originMediaHostFailed": true,
                "details": [
                    "Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."
                ]
            }
        }
    ],
    "id": "abc123",
    "refId": "65806e8d9efd78a58c05566a887043329dcdc76b",
    "post": "Your post text here"
}
```

<Tip>
  Wenn Sie `originMediaHostFailed` in Ihren Antworten sehen, kann es ein Problem mit Ihrem Medien-Hosting geben, das verhindert, dass soziale Netzwerke auf Ihre Medien zugreifen. Siehe [Meta Media Crawler blockiert](/help-center/technical-support/meta_media_crawler_blocked) für detaillierte Schritte zur Fehlerbehebung.
</Tip>

## Fehlerdetails

<Info>
  Wenn eine Instagram-Medienveröffentlichung fehlschlägt, gibt das Fehlerobjekt jetzt den zugrunde liegenden Fehlertext von Meta im Feld `details` aus, zusätzlich zu Ayrshares `code` und `message`. So können Sie zwischen verschiedenen Grundursachen unterscheiden (zum Beispiel eine Ablehnung wegen des Seitenverhältnisses gegenüber einem Fehler beim Herunterladen von Medien), ohne den Support kontaktieren zu müssen.
</Info>

```json Instagram Publish Error theme={"system"}
{
    "status": "error",
    "errors": [
        {
            "action": "post",
            "status": "error",
            "platform": "instagram",
            "code": 156,
            "message": "An error occurred while posting to Instagram.",
            "details": "The submitted image was not found. The aspect ratio is not supported. Please see https://developers.facebook.com/docs/instagram-api for more information."
        }
    ]
}
```

Der `message` ist Ayrshares stabile, menschenlesbare Zusammenfassung, während `details` den vom Meta-System zurückgegebenen Rohtext der fehlgeschlagenen Veröffentlichung wiedergibt.

## Zeilenumbrüche oder Rich Text zu einem Instagram-Beitrag hinzufügen

Instagram-Zeilenumbrüche können mit einem speziellen [Zeilenumbruchszeichen](/apis/post/post#line-breaks) zu einem Beitrag hinzugefügt werden.

Rich Text, etwa fette oder kursive Schrift, lässt sich mit einigen [HTML-Elementen](/apis/post/overview#rich-text-posts) zu einem Instagram-Beitrag hinzufügen.

## Zeichenbeschränkungen

Weitere Informationen finden Sie unter [Instagram-Zeichenbeschränkungen](/help-center/technical-support/character_limits#instagram-character-limits).

## Zusätzliche Endpunkte

<Card title="Anfragestatus eines Kollaborators abrufen" icon="code" href="/apis/utils/instagram-get-collaborator" horizontal />