> ## 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. # Facebook Page API > Optionen zum Posten mit der Facebook API export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; Wenn Sie Probleme beim Verbinden von Facebook haben, siehe den [Leitfaden zur Fehlerbehebung](/help-center/technical-support/facebook_posting_issues). ## Posten auf Facebook Das Posten über die Facebook API setzt voraus, dass eine Facebook-Page verbunden ist. Facebook erlaubt es nicht, persönliche Konten zu verbinden. JSON für einen einfachen Beitrag mit Link und Bild an eine Facebook-Page: ```json Facebook Post with Image theme={"system"} { "post": "The best FB post ever #best https://www.facebook.com", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["facebook"] } ``` Die Facebook-API unterstützt das Mischen von Bildern und Videos in einem einzelnen Beitrag nicht. Sie können mehrere Bilder ODER ein einzelnes Video einfügen, aber nicht beides. ## Karussell-Bilder Posten Sie Facebook-Karussell-Bilder über die Ayrshare API mit dem Body-Parameter `carousel`. ```json Facebook Carousel Post theme={"system"} { "faceBookOptions": { "carousel": { // The URL of the "See More At" button - required "link": "URL of See More At...", "items": [ // 2 min, 10 max elements in the array { "name": "Image name", // optional "link": "URL when image clicked", // required "picture": "URL of image" // required }, { "name": "Image name", "link": "URL when image clicked", "picture": "URL of image" } ] } } } ``` **Hinweis:** Verwenden Sie `media_urls` nicht zusammen mit `carousel`. Wenn `media_urls` gesetzt ist, wird `carousels` ignoriert. Weitere Informationen finden Sie in unserem [Facebook-Karussell-Leitfaden](https://www.ayrshare.com/blog/post-a-series-of-facebook-images-as-a-carousel/). ## Facebook Reels Sie können ein Video mit den folgenden `facebookOptions` als Facebook Reel posten. Meta setzt ein Limit von 30 Reels pro verbundener Facebook-Page innerhalb jedes 24-Stunden-Zeitraums durch, um Spam zu verhindern und die Plattformqualität sicherzustellen. Es handelt sich um ein rollierendes Limit, das sich auf die letzten 24 Stunden bezieht, nicht auf Kalendertage. ```json Facebook Reels Post theme={"system"} { "post": "The description of the video", "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/reel.mp4"], "faceBookOptions": { "reels": true, "title": "Super title for the Reel", // optional "thumbNail": "https://img.ayrshare.com/012/reel-thumbnail.jpg" // optional } } ``` Siehe die [Video-Anforderungen der Reels API](/media-guidelines/facebook_pages#reels) oder ein [Beispiel zur Nutzung der Facebook Reels API](https://www.ayrshare.com/blog/facebook-reels-api-how-to-post-fb-reels-using-a-social-media-api/). Meta hat gelegentlich Probleme, Facebook Reels für einige Konten zu verarbeiten. Auch wenn eine Fehlermeldung zurückgegeben wird, wurde der Reel möglicherweise dennoch veröffentlicht. Wenn Sie Fehler für Facebook Reels erhalten, empfehlen wir, den Reel-Status zu prüfen. Wenn der Beitrag *nicht* veröffentlicht wurde, können Sie versuchen, [ihn erneut zu posten](/apis/post/retry-post). Das ist häufig erfolgreich. Sie können die URL im Feld `verifyReelsUrl` verwenden, um den Status zu prüfen. Verwenden Sie dabei denselben Profile Key wie beim ursprünglichen Beitrag. Warten Sie bis zum Zeitpunkt in `verifyReelsIn`, um den Reel-Status zu prüfen (10 Minuten). Wenn ein HTTP-Fehlercode von `400` zurückgegeben wird, ist der Beitrag fehlgeschlagen und Sie können ihn noch einmal versuchen. ```json Facebook Reels Post Error theme={"system"} { "action": "post", "status": "error", "code": 108, "message": "Facebook Error: Facebook cannot process your post at this time. Please try again. ", "detailsData": { "id": "104619420979033_36930641143", "verifyReelsUrl": "https://api.ayrshare.com/history/36930641143?searchPlatformId=true&platform=facebook", "verifyReelsIn": "2024-01-26T00:07:05.170Z", "postUrl": "https://www.facebook.com/1046194209_36930641143", "reels": true }, "retryAvailable": true, "platform": "facebook" } ``` ## Facebook Stories Veröffentlichen Sie Facebook Stories auf Facebook-Pages entweder als Foto oder als Video. ```json Facebook Stories Post theme={"system"} { "post": "", // Ignored by stories "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"], "faceBookOptions": { "stories": true } } ``` Siehe die [Bild- und Video-Anforderungen der Stories API](/media-guidelines/facebook_pages#stories). ## Medien-Bildunterschriften Legen Sie für jedes gepostete Facebook-Bild eine Bildunterschrift fest. Akzeptiert ein Array von String-Bildunterschriften. Jeder Eintrag muss einer Medien-URL entsprechen. Z. B. bezieht sich `["This is my best pic", "😃 here is the next one"]` auf die 1. und 2. URL in `mediaUrls`. ```json Facebook Media Captions theme={"system"} { "faceBookOptions": { "mediaCaptions": ["This is my best pic", "😃 here is the next one"] } } ``` ## Standort-Tagging Ein Facebook-Standort-Tag 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 Page-Name `"@guggenheimmuseum"`. Pages müssen mit einem physischen Standort verknüpft sein. ```json Facebook Location Tagging theme={"system"} // Using the Facebook Page Id - must be associated with a location { "faceBookOptions": { "locationId": 7640348500 // Guggenheim Museum Page Id } } ``` Sie können die `locationId` (Page ID) mit dem [Brand-Endpunkt](/apis/listen/search/fb-page-search) nachschlagen. Beachten Sie, dass die Page einen Standort hinterlegt haben muss, sonst gibt die locationId einen Fehler zurück. Wird für Textbeiträge, Bilder, Reels und Stories nicht unterstützt. Videos werden von Meta für Standort-Tagging nicht unterstützt. ## Zielgruppen-Targeting Beim Erstellen eines Page-Beitrags auf Facebook können Sie die Sichtbarkeit über zwei Arten von Targeting auf eine bestimmte Zielgruppe beschränken: 1. Facebook Targeting: Ermöglicht es Ihnen, die Zielgruppe Ihres Beitrags anhand von Faktoren wie Alter, Geschlecht, Standort und Beziehung zu definieren. Durch das Setzen dieser Parameter stellen Sie sicher, dass Ihr Beitrag nur für Personen angezeigt wird, die die angegebenen Kriterien erfüllen. 2. Facebook Feed Targeting: Diese Option ermöglicht es Ihnen, die Sichtbarkeit Ihres Beitrags in den News Feeds Ihrer Zielgruppe weiter zu verfeinern. Sie können jede Targeting-Option einzeln oder in Kombination verwenden. ### Targeting Facebook-Targeting [beschränkt die Zielgruppe](https://www.facebook.com/help/352402648173466) für die Veröffentlichung von Inhalten auf bestimmte demografische Merkmale. Personen, die nicht in diese Merkmale fallen, können den Inhalt nicht sehen. Bereits vorhandene demografische Beschränkungen auf Page-Ebene werden dadurch nicht überschrieben. Verfügbare demografische Felder unter `targeting`: ```json Facebook Targeting theme={"system"} { "faceBookOptions": { "targeting": { "ageMin": 18, "countries": ["DE", "BR"] } } ``` ### Feed-Targeting Personen in diesen Facebook-Feed-Targeting-Gruppen sehen den Beitrag mit höherer Wahrscheinlichkeit; andere sehen ihn zwar mit geringerer Wahrscheinlichkeit, können ihn aber dennoch sehen. Verwenden Sie Targeting (siehe oben), wenn Sie die Einschränkung garantieren möchten. Verfügbare demografische Felder für `feedTargeting`: ```json Facebook Feed Targeting theme={"system"} { "feedTargeting": { "ageMax": 30, "ageMin": 26, "countries": ["DE", "BR"], "genders": [1, 2], "relationshipStatuses": [1, 2] } } ``` ## Alternativtext Fügen Sie einem Bild oder Video einen Facebook-Alternativtext (Alt-Text) hinzu. Der Facebook-Alt-Text ist eine Barrierefreiheitsfunktion für zusätzliche Nutzerinformationen und Screenreader. Verwenden Sie `altText` im Objekt `faceBookOptions`. ```json Facebook Alt Text theme={"system"} { "faceBookOptions": { // 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. ## Video-Thumbnail Legen Sie ein Facebook-Video-Thumbnail (Titelbild) fest. Senden Sie eine Remote-URL einer PNG- oder JPG-Datei, die dieselben Abmessungen wie das Video hat und kleiner als 10 MB ist. Die URL sollte auf .png oder .jpg enden. ```json Example Facebook Video Thumbnail theme={"system"} { "faceBookOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` ## Video-Titel Fügen Sie einen Facebook-Videotitel mit dem Parameter `title` hinzu. ```json Facebook Video Title theme={"system"} { "faceBookOptions": { "title": "The best video ever!" } } ``` ## Animierte GIFs Beim Posten eines animierten Facebook-GIFs ist nur eine `mediaUrls`-URL im Array erlaubt. Wenn die Medien-URL nicht auf „.gif" oder „.GIF" endet, setzen Sie das Feld `isVideo` auf `true`. ```json Facebook Animated GIF theme={"system"} { "randomPost": true, "platforms": ["facebook"], // Set to true if the GIF URL does not end in .gif or .GIF "isVideo": false, // Only one URL is allowed in the array "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"] } ``` ## Facebook-Page-Erwähnungen Sie können eine andere Facebook-Page (auch bekannt als Facebook-Erwähnung oder Facebook-Tagging) erwähnen, indem Sie den Facebook-Page-Namen oder die Page-ID im Beitragstext angeben. Facebook erlaubt keine Erwähnungen oder Markierungen persönlicher Profile oder Gruppen. Fügen Sie eine Erwähnung mit dem folgenden @mention hinzu: `@page-name` oder `@[page-id]` ### Erwähnung mit Page-Name Ein Beispiel-Beitragstext mit Page-Namen. Sie finden den Page-Namen in der Facebook-URL, z. B. [https://www.facebook.com/Ayrshare](https://www.facebook.com/Ayrshare). ```json Facebook Page Mention with Page Name theme={"system"} { "post": "This is the best social media api by @Ayrshare" } ``` Ayrshare versucht bestmöglich, die passende Page anhand des Namens zu finden, aber manchmal wird keine Übereinstimmung gefunden. Eine zuverlässigere Methode ist die Verwendung einer Page-ID. ### Erwähnung mit Page-ID Ein Beispiel-Beitragstext mit einer Page-ID; beachten Sie die Verwendung von \[]. Unten erfahren Sie, wie Sie die Page-ID finden. ```json Facebook Page Mention with Page ID theme={"system"} { "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID } ``` Die Facebook-Page-ID wird zur passenden Page aufgelöst und ***benachrichtigt die erwähnte Page***. Verwenden Sie Page-Erwähnungen mit Bedacht und erwähnen Sie nur Pages, mit denen Sie in Verbindung stehen. Achten Sie darauf, niemals zu spammen. Wenn Sie eine Page erwähnen, **wird der Eigentümer der Page per Alert und E-Mail benachrichtigt**. Beschweren sich mehrere Pages darüber, dass Sie sie erwähnen, könnte Facebook Ihr Konto sperren. In der Regel sollten Sie nur Pages taggen, mit denen Sie eine etablierte Beziehung haben. Die erwähnte Facebook-Page **muss zulassen**, dass andere Pages ihre Page erwähnen/taggen. Erwähnungen können in den allgemeinen Einstellungen der Page unter „Others Tag this Page" aktiviert werden. Bitte lesen Sie die [wichtigen Regeln](/testing/post-verification#mentions) zu Erwähnungen. ### Eine Facebook-Page-ID finden #### Brand-Endpunkt Sie können einen Facebook-Nutzer oder eine Facebook-Page über die [Brand-Endpunkte](/apis/brand/overview) nachschlagen. #### Auf Facebook.com 1. Klicken Sie im Facebook News Feed im linken Seitenmenü auf **Pages**. 2. Klicken Sie auf den Namen Ihrer Page, um zu Ihrer Page zu gelangen. 3. Klicken Sie oben auf Ihrer Page auf **About**. Wenn Sie es nicht sehen, klicken Sie auf **More**▼. 4. Scrollen Sie nach unten und finden Sie Ihre **Page ID** unter **MORE INFO**. oder wenn Sie die ID einer Page finden möchten, die Ihnen nicht gehört: `https://www.facebook.com/pages/ayrshare/123466789203`, dann ist die Page-ID die Zahl am Ende, also **123466789203**. Sie können prüfen, ob die Page-ID korrekt ist, indem Sie zu `https://facebook.com/page-id` gehen; die URL wird zur Page aufgelöst. Sie können auch ein Facebook-Page-Lookup-Tool eines Drittanbieters testen, das nicht von Ayrshare unterstützt wird, z. B.: [https://lookup-id.com/](https://lookup-id.com/) Wenn alle anderen Methoden fehlschlagen, können Sie die Facebook-Page in einem Browser öffnen und den Seitenquelltext anzeigen. Klicken Sie in Chrome mit der rechten Maustaste und wählen Sie „View Source". Suchen Sie dann entweder nach `owning_profile_id` oder `profile_id`, um die Page-ID zu finden. Bitte lesen Sie die [wichtigen Regeln](/testing/post-verification#mentions) zu Erwähnungen. ### Page-Erwähnungen aktivieren Die Page muss Erwähnungen und Tagging in Beiträgen und Kommentaren zulassen. Standardmäßig ist dies aktiviert, aber Sie können es überprüfen, indem Sie sich bei facebook.com anmelden und zu Ihrer Page wechseln. 1. Klicken Sie in der Ansicht als Ihre Page oben rechts auf das **Profilbild** Ihrer Page. 2. Klicken Sie auf **Settings & Privacy** -> **Settings**. 3. Klicken Sie im Menü „Settings" auf **Privacy**. 4. Klicken Sie auf **Page and Tagging**. 5. Scrollen Sie nach unten zu **Reviewing**. 6. Schalten Sie die Einstellungen um, um Tag- und Erwähnungen zuzulassen. ## Meta Business Suite ### Entwurfsbeiträge Erstellen Sie einen Facebook-Entwurfsbeitrag, der im Tab [Meta Business Suite Draft](https://business.facebook.com/latest/posts/draft_posts) erscheint. Facebook-Entwurfsbeiträge sind Beiträge, die Sie begonnen haben zu schreiben, aber noch nicht veröffentlicht haben. Sie können Entwurfsbeiträge speichern, um später darauf zurückzukommen, oder sie zur späteren Veröffentlichung planen. Fügen Sie den Parameter `draft` zu `faceBookOptions` hinzu, um den Beitrag als Entwurf zu senden. Verfügbar für Text-, Bild-, Video- und Reels-Beiträge. ```json Facebook Draft Post theme={"system"} { "faceBookOptions": { "draft": true } } ``` ### Geplante Veröffentlichungszeit Legen Sie eine geplante Veröffentlichungszeit für Facebook-Beiträge fest, die im Tab [Meta Business Suite Scheduled Posts](https://business.facebook.com/latest/posts/scheduled_posts) erscheinen. Geplante Facebook-Beiträge sind Beiträge, die Sie erstellt und für eine spätere Veröffentlichung geplant haben und die in der Meta Business Suite verwaltet werden. Das kann nützlich sein, um Ihre Social-Media-Beiträge im Voraus zu planen oder Beiträge zu Zeiten zu veröffentlichen, in denen Ihr Publikum am aktivsten ist. Verfügbar für Text-, Bild-, Video- und Reels-Beiträge. Die Veröffentlichungszeit muss mehr als 10 Minuten in der Zukunft und innerhalb von 29 Tagen ab dem aktuellen Datum liegen. Sofern Sie Facebook-Beiträge nicht in der Meta Business Suite verwalten müssen, empfehlen wir die Verwendung des standardmäßigen [Beitrags-Planungsdatums](/apis/post/overview#schedule-posts). Fügen Sie den Parameter `scheduledPublishDate` zu `faceBookOptions` hinzu, um eine Beitragszeit zu planen. ```json Facebook Scheduled Post theme={"system"} { "faceBookOptions": { "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC } } ``` ## Link-Vorschau Ein Facebook-Beitrag erstellt automatisch eine Link-Vorschau für einen Link im Beitragstext. Wenn Sie jedoch einen anderen Link angeben oder die Link-Vorschau erzwingen möchten, verwenden Sie den Parameter `link` mit der URL des Links. ```json Facebook Link Preview theme={"system"} { "faceBookOptions": { "link": "https://www.ayrshare.com/instagram-hashtag-guide/" } } ``` Wenn im Post-Request das Feld `mediaUrls` enthalten ist, werden die Medien anstelle der Link-Vorschau angezeigt. ## Facebook Ads Facebook Ads sind eine Möglichkeit, Ihre Beiträge einem breiteren Publikum zu präsentieren. ## Zeichenbeschränkungen Weitere Informationen finden Sie unter [Facebook-Zeichenbeschränkungen](/help-center/technical-support/character_limits#facebook-character-limits). ## Weitere Informationen ### Wie füge ich Zeilenumbrüche oder Rich Text zu einem Facebook-Beitrag hinzu? Facebook-Zeilenumbrüche können mit einem speziellen [Zeilenumbruchszeichen](/apis/post/overview#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 Facebook-Beitrag hinzufügen. ### Warum sehe ich „Published by Ayrshare" bei einem Beitrag? Keine Sorge, es wird nur in der Admin-Ansicht angezeigt. Weitere Informationen finden Sie im [Leitfaden zur Fehlerbehebung](/help-center/technical-support/facebook_shows_published_by_ayrshare).