Facebook Page API

​

Posten auf Facebook

{
  "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"]
}

• Facebook zeigt automatisch eine Vorschau des Links im Beitrag an, sofern kein Bild oder Video enthalten ist. Im obigen Beispiel wird das Bild angezeigt. Wenn Sie das Bild entfernen, wird die Link-Vorschau angezeigt.
• Wenn Ihr Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter isVideo. Weitere Informationen finden Sie unter /post-Endpunkt.
• Facebook unterstützt auch das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten, senden Sie einen leeren String post: "".
• Weitere Informationen finden Sie unter Facebook-Medienrichtlinien und Facebook-Autorisierung.

​

Karussell-Bilder

{
  "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"
        }
      ]
    }
  }
}

• Der Parameter link auf oberster Ebene ist die URL am Ende des Karussells.
• Das Feld items ist ein Array von Objekten mit den folgenden Werten. Mindestens 2 und maximal 10 Elemente im items-Array.
• picture – URL des Karussell-Bildes.
• link – URL, wenn das Bild angeklickt wird.
• name – (optional) In jeder Bildkarte angezeigter Text.

​

Facebook Reels

{
  "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
  }
}

• reels: Auf true setzen, um das Video als Reel zu posten. Erforderlich, wenn Sie in Facebook Reels posten möchten.
• title: Der Titel des Videos mit maximal 255 Zeichen. Werte über 255 Zeichen werden abgeschnitten. Optional.
• thumbNail: Das Thumbnail (Titelbild) des Videos. Das Thumbnail sollte eine URL zu einer JPEG- oder PNG-Datei sein. Es sollte kleiner als 10 MB sein. Optional.

{
  "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

• Facebook Stories unterstützen keinen Beitragstext – jeglicher Text im Feld post, einschließlich Erwähnungen, wird ignoriert.
• Ein für eine Story hochgeladenes Foto oder Video darf zuvor nicht in einem veröffentlichten Beitrag verwendet worden sein.
• Eine Video-Story darf 60 Sekunden nicht überschreiten.
• Aktivieren Sie das Stories-Archiv, um Stories per GET abrufen zu können.

{
  "post": "", // Ignored by stories
  "platforms": ["facebook"],
  "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"],
  "faceBookOptions": {
    "stories": true
  }
}

​

Medien-Bildunterschriften

{
  "faceBookOptions": {
    "mediaCaptions": ["This is my best pic", "😃 here is the next one"]
  }
}

​

Standort-Tagging

// Using the Facebook Page Id - must be associated with a location
{
  "faceBookOptions": {
    "locationId": 7640348500 // Guggenheim Museum Page Id
  }
}

​

Zielgruppen-Targeting

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.

​

Targeting

• ageMin: Beschränkt das Mindestalter, ab dem die Beiträge angezeigt werden. Zulässige Werte sind 13, 15, 18, 21 oder 25. Andere Altersangaben werden abgelehnt.
• countries: Auch als Geofencing bekannt – Sie können die Länder beschränken, in denen der Beitrag angezeigt werden kann. Array von Ländercodes. Es können maximal 25 Länder gezielt angesprochen werden. Wenn Sie mehr als 25 Länder ansprechen oder bestimmte Länder ausschließen möchten, siehe Facebook Page Country Restrictions.

{
    "faceBookOptions": {
        "targeting": {
            "ageMin": 18,
            "countries": ["DE", "BR"]
    }
}

​

Feed-Targeting

• ageMin: Beschränkt das Mindestalter, ab dem der Beitrag angezeigt wird. Ganzzahliger Wert 13 oder höher. Standardwert ist 0.
• ageMax: Beschränkt das Höchstalter, bis zu dem der Beitrag angezeigt wird. Ganzzahliger Wert 65 oder niedriger.
• countries: Auch als Geo-Targeting bezeichnet – Sie können die Länder angeben, in denen der Beitrag angezeigt werden soll. Array von Ländercodes.
• collegeYears: Zielt auf das College-Absolventenjahr ab, um den Beitrag anzuzeigen. Array ganzer Zahlen für das Abschlussjahr am College.
• educationStatuses: Zielt auf den Bildungsstatus ab, um den Beitrag anzuzeigen. Array ganzer Zahlen für das Targeting basierend auf dem Bildungsniveau. Verwenden Sie 1 für High School, 2 für Undergraduate und 3 für Alumni.
• genders: Zielt auf das Geschlecht ab, um den Beitrag anzuzeigen. Array ganzer Zahlen für das Targeting bestimmter Geschlechter. 1 zielt auf alle männlichen Zuschauer, 2 auf weibliche. Standardmäßig werden beide angesprochen.
• relationshipStatuses: Zielt auf den Beziehungsstatus ab, um den Beitrag anzuzeigen. Array ganzer Zahlen für das Targeting basierend auf dem Beziehungsstatus. Verwenden Sie 1 für Single, 2 für ‘in a relationship’, 3 für verheiratet und 4 für verlobt. Standard sind alle Typen.

{
  "feedTargeting": {
    "ageMax": 30,
    "ageMin": 26,
    "countries": ["DE", "BR"],
    "genders": [1, 2],
    "relationshipStatuses": [1, 2]
  }
}

​

Alternativtext

{
  "faceBookOptions": {
    // Array of Alt Texts
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}

​

Video-Thumbnail

{
  "faceBookOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}

​

Video-Titel

{
  "faceBookOptions": {
    "title": "The best video ever!"
  }
}

​

Animierte GIFs

{
  "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

​

Erwähnung mit Page-Name

{
  "post": "This is the best social media api by @Ayrshare"
}

​

Erwähnung mit Page-ID

{
  "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID
}

​

Eine Facebook-Page-ID finden

​

Brand-Endpunkt

​

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.

• Wenn die Facebook-Page eine URL wie https://www.facebook.com/ayrshare-1234567890 hat, ist die ID 1234567890.
• Wenn die Facebook-Page eine URL wie folgt hat:

​

Page-Erwähnungen aktivieren

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

{
  "faceBookOptions": {
    "draft": true
  }
}

​

Geplante Veröffentlichungszeit

{
  "faceBookOptions": {
    "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC
  }
}

​

Link-Vorschau

{
  "faceBookOptions": {
    "link": "https://www.ayrshare.com/instagram-hashtag-guide/"
  }
}

​

Facebook Ads

​

Zeichenbeschränkungen

​

Weitere Informationen

​

Wie füge ich Zeilenumbrüche oder Rich Text zu einem Facebook-Beitrag hinzu?

​

Warum sehe ich „Published by Ayrshare” bei einem Beitrag?