> ## 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.

# Meta-Media-Crawler blockiert (Instagram / Threads)

> Beheben Sie error 479, wenn robots.txt oder eine WAF Metas Crawler facebookexternalhit für Instagram- oder Threads-Medien blockiert. Testen Sie mit curl.

Der Fehlercode **479** ist der eigens dafür vorgesehene, **nicht wiederholbare** Ayrshare-Code, der zurückgegeben wird, wenn Meta Ihre Medien-URL nicht abrufen kann. Am häufigsten liegt das daran, dass `robots.txt` oder eine Bot-Blocking-Regel auf Ihrem Server dem Crawler (`facebookexternalhit`) den Zugriff verweigert. Er wird erst zurückgegeben, nachdem auch der automatische Re-Hosting-Fallback von Ayrshare fehlgeschlagen ist, was stark auf eine Blockierung auf Seiten des Hosts oder eine nicht erreichbare Quelle hindeutet.

Wenn Ayrshare auf Instagram oder Threads veröffentlicht, übergibt es Ihre URL nicht einfach an Meta und gibt dann auf. Ayrshare wiederholt den Abruf automatisch und **hostet, falls Meta die Medien weiterhin nicht erreicht, eine Kopie auf seinem eigenen CDN** und lässt Meta stattdessen diese abrufen. Code **479** bedeutet, dass selbst dieser Fallback Meta nicht dazu bringen konnte, die Medien abzurufen. Ein erneuter Versuch derselben Anfrage hilft daher erst, wenn das zugrunde liegende Hosting-Problem behoben ist (`retryAvailable: false`, HTTP 400).

> [!NOTE]
>
> Diese Seite behandelt Fehler, bei denen in der Fehlermeldung oder den Details erwähnt wird, dass das soziale Netzwerk die Medien nicht herunterladen konnte, in der Regel mit Verweisen auf `facebookexternalhit`, `robots.txt`, `"Restricted by robots.txt"`, `"HTTP error code 403"` oder den Meta-Fehler `2207052`. Bei Seitenverhältnis- oder Formatfehlern zum Instagram-Code 138 lesen Sie stattdessen die [Instagram Media Guidelines](https://www.ayrshare.com/docs/media-guidelines/instagram.md) oder die [Threads Media Guidelines](https://www.ayrshare.com/docs/media-guidelines/threads.md).

## Symptom

Wenn der Crawler blockiert ist, sehen Sie Fehler wie diese:

```json Error 479 (primary — dedicated, non-retryable) theme={"system"}
{
  "status": "error",
  "errors": [{
    "action": "post",
    "code": 479,
    "retryAvailable": false,
    "message": "The social network could not fetch the media from this URL, even after Ayrshare re-hosted it on its own CDN (Instagram/Meta subcode 2207052). Ensure the file is publicly reachable by Meta's crawlers (facebookexternalhit / Facebot) — check your robots.txt and any WAF/bot rules — not only in a browser. Retrying the same URL will not help until hosting is fixed.",
    "details": "Media download has failed.: The media could not be fetched from the provided URI. Restricted by robots.txt (HTTP error code 403). Meta subcode 2207052.",
    "platform": "instagram",
    "status": "error"
  }],
  "postIds": [],
  "id": "..."
}
```

```json Error 440 (transient ingestion — retryable) theme={"system"}
{
  "status": "error",
  "errors": [{
    "action": "post",
    "code": 440,
    "retryAvailable": true,
    "message": "The social network could not ingest the media in time. This is usually transient (for example Meta subcode 2207032 'download too slow' or 2207003 'create media fail'). Retry the post.",
    "details": "Media download has failed.: Media download took too long / could not create media...",
    "platform": "instagram",
    "status": "error"
  }],
  "postIds": [],
  "id": "..."
}
```

```json Instagram Error 138 (fallback — less specific upstream response) theme={"system"}
{
  "status": "error",
  "errors": [{
    "retryAvailable": true,
    "status": "error",
    "code": 138,
    "details": "Media download has failed.: The media could not be fetched from the provided URI. Video download failed with: HTTP error code 403. Restricted by robots.txt",
    "action": "post",
    "platform": "instagram",
    "message": "Instagram Error: Instagram cannot process your post at this time. Please try your post again."
  }],
  "postIds": [],
  "id": "..."
}
```

```json Threads Error 379 theme={"system"}
{
  "status": "error",
  "errors": [{
    "status": "error",
    "code": 379,
    "message": "Error posting to Threads.",
    "action": "post",
    "platform": "threads"
  }],
  "postIds": [],
  "id": "..."
}
```

> [!NOTE]
>
> So unterscheiden sich diese Codes:
>
> <ul>
>   <li>**Code 479: eigener Code für Medienabruf / Crawler-Blockierung (nicht wiederholbar).** Das ist der Code für den Fehler, den diese Seite behandelt. Er wird mit `retryAvailable: false` zurückgegeben, wenn Meta die Medien (Subcode `2207052` oder ein Textmuster für einen Medienabruf) **selbst dann nicht abrufen konnte, nachdem Ayrshare sie auf seinem eigenen CDN erneut gehostet hatte**. Seine Meldung nennt ausdrücklich `facebookexternalhit` / `Facebot` und `robots.txt`. Wenn Sie 479 sehen, sind Sie hier richtig. Beheben Sie das Hosting, bevor Sie es erneut versuchen.</li>
>   <li>**Code 440: vorübergehende Ingestion (wiederholbar).** Wird jetzt für tatsächlich vorübergehende Ingestion-Ausfälle verwendet: Meta-Subcodes `2207032` ("download too slow") / `2207003` ("create media fail") oder nicht klassifizierte Ausfälle. Er enthält `retryAvailable: true`; versuchen Sie es über [`/post/retry`](https://www.ayrshare.com/docs/apis/post/retry-post) erneut.</li>
>   <li>**Code 138: weniger spezifischer Instagram-Fallback.** Wird für dieselbe Grundursache ausgegeben, wenn die Upstream-Antwort weniger spezifisch ist. 138 wird auch für Seitenverhältnis-/Formatprobleme verwendet, sodass die Media-Fetch-Variante durch `"Restricted by robots.txt"` oder `"HTTP error code 403"` in `details` erkennbar ist.</li>
>   <li>**Code 379: Threads.** Enthält kein `details`-Feld. Wenn Threads gleichzeitig mit einem Instagram 479 oder 138 fehlschlägt, ist die Grundursache typischerweise dieselbe.</li>
> </ul>

## Warum das passiert

Wenn Sie über Ayrshare auf Instagram oder Threads veröffentlichen, rufen die Meta-Server Ihre Medien von der angegebenen URL ab. Dieser serverseitige Abruf verwendet den User-Agent `facebookexternalhit`. Wenn `robots.txt` Ihres Servers diesen Crawler ausschließt – oder eine WAF/Bot-Schutzregel ihn blockiert – kann Meta die Datei nicht herunterladen, und die Veröffentlichung schlägt fehl.

Für die Veröffentlichung auf Facebook-Seiten wird ein anderer Ingestion-Pfad genutzt, weshalb dieselbe `mediaUrl` für Facebook funktionieren, für Instagram und Threads aber fehlschlagen kann.

## Fix: Aktualisieren Sie Ihre robots.txt

### Empfohlen: Meta explizit erlauben, andere Crawler offen lassen

Fügen Sie diese Regeln zu Ihrer `robots.txt`-Datei hinzu:

```txt robots.txt theme={"system"}
User-agent: facebookexternalhit
Allow: /

User-agent: *
Allow: /
```

Dies erlaubt Metas Crawler ausdrücklich, während Ihre Website für andere Crawler (Google, Bing usw.) geöffnet bleibt.

### Fortgeschritten: Nur für Social-Media-Publisher freigeben

Wenn Sie die meisten Crawler blockieren, aber Social-Media-Plattformen erlauben möchten:

```txt robots.txt theme={"system"}
User-agent: facebookexternalhit
Allow: /

User-agent: Twitterbot
Allow: /

User-agent: LinkedInBot
Allow: /

User-agent: Pinterest
Allow: /

User-agent: *
Disallow: /
```

> [!WARNING]
>
> Verwenden Sie einen einzelnen `User-agent: *`-Block, platziert am Ende der Datei. RFC-9309-konforme Crawler führen mehrere Wildcard-Gruppen zu einer zusammen, aber nicht jeder in freier Wildbahn eingesetzte Parser ist RFC-konform – doppelte Wildcard-Gruppen sind eine häufige Ursache dafür, dass Regeln verworfen oder inkonsistent angewendet werden.

## Prüfen, ob Meta Ihre URL abrufen kann

Bevor Sie Ihren Beitrag erneut versuchen, verifizieren Sie, dass Metas Crawler nun auf Ihre Medien zugreifen kann. Führen Sie diesen Befehl aus und ersetzen Sie `$URL` durch Ihre vollständige Medien-URL:

```bash theme={"system"}
curl -v --compressed -H "Range: bytes=0-524288" -H "Connection: close" \
  -A "facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)" \
  "$URL"
```

<ul>
  <li>**Healthy response:** HTTP 200 oder 206 mit Binärdaten im Body.</li>
  <li>**Blocked response:** HTTP 403 oder eine leere/HTML-Fehlerseite.</li>
</ul>

> [!NOTE]
>
> Laut Meta-Dokumentation können Änderungen an `robots.txt` bis zu 24 Stunden benötigen, um sich im Crawler-Cache von Meta zu verbreiten. Wenn die Verifizierung erfolgreich ist, Ihr Beitrag aber weiterhin fehlschlägt, warten Sie und versuchen Sie es später erneut.

## Wenn dies das Problem nicht behebt

Wenn Sie `robots.txt` aktualisiert und mit dem `curl`-Befehl verifiziert haben, aber weiterhin Fehler sehen:

<ul>
  <li>**24-Stunden-Verbreitungsverzögerung** – Meta cached `robots.txt`. Warten Sie nach Änderungen bis zu 24 Stunden, bevor Sie es erneut versuchen.</li>
  <li>**WAF- oder Bot-Fight-Regeln** – Cloudflare Bot Fight Mode, AWS-WAF-Managed-Bot-Regelgruppen und ähnliche Dienste können die Crawler-IP-Bereiche von Meta blockieren, selbst wenn `robots.txt` dies erlaubt. Prüfen Sie Ihre WAF-Logs und fügen Sie eine Ausnahme für `facebookexternalhit` hinzu.</li>
  <li>**Hotlink-Schutz / Referer-Prüfungen** – Einige CDNs blockieren Anfragen von Rechenzentrums-IPs oder ohne gültigen `Referer`-Header. Setzen Sie Metas Crawler auf die Whitelist oder deaktivieren Sie den Hotlink-Schutz für Medien-Pfade.</li>
  <li>**Ablauf von Signed-/Presigned-URLs** – Wenn Ihre Medien-URL einen Ablaufzeitstempel besitzt (häufig bei S3-Presigned-URLs), stellen Sie sicher, dass sie nicht abläuft, bevor Metas Crawler sie abrufen kann. Bei geplanten Beiträgen erzeugen Sie URLs, die bis deutlich nach der geplanten Zeit gültig sind.</li>
  <li>**Managed Media Hosting** – Wenn Sie einen Dienst wie Cloudinary, Imgix oder ähnlich nutzen, bei dem Sie `robots.txt` nicht bearbeiten können, prüfen Sie in deren Dokumentation eine Allow-List-Einstellung für Meta-/Facebook-Crawler.</li>
</ul>

Wenn keine dieser Maßnahmen das Problem behebt, [kontaktieren Sie den Ayrshare-Support](https://www.ayrshare.com/contact) und geben Sie an:

* Die fehlgeschlagene `postId` aus der Fehlerantwort
* Die Ausgabe des oben genannten `curl`-Verifizierungsbefehls
* Den Inhalt Ihrer `robots.txt`

## Fehlgeschlagenen Beitrag wiederholen

Wie Sie erneut versuchen, hängt davon ab, welchen Code Sie erhalten haben:

<ul>
  <li>**Code 440 (vorübergehend, `retryAvailable: true`)**: Für die Ingestion ist einfach die Zeit abgelaufen, oder es ist ein vorübergehender Meta-Fehler aufgetreten. Versuchen Sie es direkt über den [Retry-Post-Endpunkt](https://www.ayrshare.com/docs/apis/post/retry-post.md) erneut; Änderungen an Ihrem Hosting sind nicht nötig.</li>
  <li>**Code 479 (`retryAvailable: false`)**: Meta konnte die Medien selbst dann nicht abrufen, nachdem Ayrshare sie auf seinem eigenen CDN erneut gehostet hatte. Ein erneuter Versuch mit der unveränderten, blockierten URL schlägt daher wieder fehl. **Beheben Sie zuerst das Hosting**: Erlauben Sie die Crawler von Meta (`facebookexternalhit` / `Facebot`) in `robots.txt` und in Ihrer WAF, oder hosten Sie die Medien auf einem CDN, das Meta erreichen kann. Prüfen Sie dies mit dem `curl`-Befehl oben und versuchen Sie es dann über den [Retry-Post-Endpunkt](https://www.ayrshare.com/docs/apis/post/retry-post.md) erneut.</li>
</ul>

## Siehe auch

<ul>
  <li>[Instagram API](https://www.ayrshare.com/docs/apis/post/social-networks/instagram.md)</li>
  <li>[Threads API](https://www.ayrshare.com/docs/apis/post/social-networks/threads.md)</li>
  <li>[Instagram Media Guidelines](https://www.ayrshare.com/docs/media-guidelines/instagram.md)</li>
  <li>[Threads Media Guidelines](https://www.ayrshare.com/docs/media-guidelines/threads.md)</li>
  <li>[Ayrshare Error Codes](https://www.ayrshare.com/docs/errors/errors-ayrshare.md#media-fetch-crawler-access-errors)</li>
  <li>[Video Publishing Fails](https://www.ayrshare.com/docs/help-center/technical-support/video-publishing-fails.md)</li>
</ul>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.