API Facebook Page - Ayrshare API Documentation

Si vous rencontrez des problèmes de connexion à Facebook, consultez le guide de dépannage.

Publier sur Facebook

Publier via l’API Facebook nécessite de connecter une Page Facebook. Facebook n’autorise pas la connexion de comptes personnels. JSON pour une publication de base avec un lien et une image sur une Page Facebook :

Facebook Post with Image

{
  "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 affichera automatiquement un aperçu du lien dans la publication sauf si une image ou une vidéo est incluse. Dans l’exemple ci-dessus, c’est l’image qui s’affichera. Retirer l’image affichera l’aperçu du lien.
Si votre vidéo ne se termine pas par une extension vidéo connue telle que mp4, utilisez le paramètre isVideo. Consultez le point de terminaison /post pour plus de détails.
Facebook prend également en charge l’envoi de médias sans texte. Si vous ne souhaitez pas inclure de texte, envoyez une chaîne vide post: "".
Consultez Facebook Media Guidelines et Facebook Authorization pour plus d’informations.

L’API de Facebook ne prend pas en charge le mélange d’images et de vidéos dans une même publication. Vous pouvez inclure plusieurs images OU une seule vidéo, mais pas les deux.

Carrousel d’images

Publiez des images en carrousel Facebook via l’API Ayrshare avec le paramètre de corps carousel.

Facebook Carousel Post

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

Le paramètre link de premier niveau est l’URL à la fin du carrousel.
items est un tableau d’objets contenant les valeurs suivantes. Minimum 2 éléments et maximum 10 éléments dans le tableau items.
picture — URL de l’image du carrousel.
link — URL ouverte quand l’image est cliquée.
name — (facultatif) libellé affiché sur chaque carte image.

Remarque : n’utilisez pas media_urls avec carousel. Si media_urls est utilisé, carousels sera ignoré. Consultez notre guide Facebook Carousel pour plus d’informations.

Facebook Reels

Vous pouvez publier une vidéo sur Facebook Reels avec les facebookOptions suivants.

Meta impose une limite de 30 Reels par Page Facebook connectée sur toute période de 24 heures pour éviter le spam et garantir la qualité de la plateforme. Il s’agit d’une limite glissante : elle compte les 24 dernières heures, pas les jours calendaires.

Facebook Reels Post

{
  "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 : définissez sur true pour publier la vidéo sur Reels. Requis si vous voulez publier sur Facebook Reels.
title : le titre de la vidéo, maximum 255 caractères. Au-delà de 255 caractères, il sera tronqué. Facultatif.
thumbNail : la miniature (image de couverture) de la vidéo. La miniature doit être une URL vers un fichier JPEG ou PNG. Elle doit peser moins de 10 Mo. Facultatif.

Consultez les exigences vidéo de l’API Reels ou un exemple d’utilisation de l’API Facebook Reels.

Meta rencontre parfois des problèmes de traitement des Facebook Reels pour certains comptes. Même si une réponse d’erreur est renvoyée, le Reel a peut-être quand même été publié.Si vous rencontrez des erreurs pour les Facebook Reels, nous recommandons de vérifier le statut du Reel. Si la publication n’a pas été diffusée, vous pouvez réessayer de publier. Cela réussit souvent.Vous pouvez utiliser l’URL contenue dans le champ verifyReelsUrl pour vérifier le statut. Veillez à utiliser la même Profile Key que votre publication d’origine. Attendez l’heure indiquée dans verifyReelsIn pour vérifier le statut du Reel (10 minutes). Si un code d’erreur HTTP 400 est renvoyé, la publication a échoué et vous pouvez tenter la publication une nouvelle fois.

Facebook Reels Post Error

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

Publiez des Facebook Stories sur des Pages Facebook, sous forme de photo ou de vidéo.

Les Facebook Stories ne prennent pas en charge le texte de publication — tout texte fourni dans le champ post, y compris les mentions, sera ignoré.
Une photo ou une vidéo téléversée pour une story ne peut pas avoir été utilisée dans une publication précédemment diffusée.
Une story vidéo ne peut pas dépasser 60 secondes.
Activez Stories Archive pour pouvoir récupérer les stories via GET.

Facebook Stories Post

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

Consultez les exigences d’image et de vidéo de l’API Stories.

Légendes des médias

Définissez une légende Facebook pour chaque image publiée. Accepte un tableau de chaînes de texte de légende. Chaque tableau doit correspondre à une URL de média. Par ex. [“This is my best pic”, ”😃 here is the next one”] fait référence aux 1re et 2e URLs dans mediaUrls.

Facebook Media Captions

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

Marquage de lieu

Un marquage de lieu Facebook est spécifié par un locationId, qui est un ID de Page Facebook ou un nom de Page Facebook. Par exemple, l’ID de Page Facebook du Guggenheim Museum est 7640348500 ou le nom de Page Facebook "@guggenheimmuseum". Les Pages doivent être associées à un lieu physique.

Facebook Location Tagging

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

Vous pouvez rechercher le locationId (ID de Page) avec le point de terminaison brand. Notez que la Page doit avoir un lieu répertorié, sinon locationId renverra une erreur. Non pris en charge pour les publications texte, images, reels et stories. Les vidéos ne sont pas prises en charge par Meta pour le marquage de lieu.

Ciblage d’audience

Lors de la création d’une publication de Page sur Facebook, vous avez la possibilité de limiter sa visibilité à une audience spécifique à l’aide de deux types de ciblage :

Targeting Facebook : vous permet de définir l’audience de votre publication en fonction de facteurs tels que l’âge, le sexe, la localisation et la relation. En définissant ces paramètres, vous vous assurez que votre publication n’est présentée qu’aux personnes correspondant aux critères spécifiés.
Feed Targeting Facebook : cette option vous permet d’affiner davantage la visibilité de votre publication dans le fil d’actualité de l’audience ciblée.

Vous pouvez utiliser chaque option de ciblage individuellement ou les combiner.

Targeting

Le targeting Facebook limite l’audience pour la publication de contenu à des données démographiques spécifiques. Toute personne en dehors de ces catégories démographiques ne pourra pas voir ce contenu. Cela ne remplacera pas les éventuelles restrictions démographiques appliquées au niveau de la Page. Champs démographiques disponibles pour targeting :

ageMin : limitez l’âge minimum qui peut voir les publications. Valeurs acceptées : 13, 15, 18, 21 ou 25. Les autres âges seront rejetés.
countries : également appelé geofencing, vous pouvez limiter les pays pouvant voir la publication. Tableau de codes pays. Le nombre maximum de pays pouvant être ciblés est de 25. Si vous devez cibler plus de 25 pays, ou restreindre certains pays, consultez Facebook Page Country Restrictions.

Facebook Targeting

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

Feed Targeting

Les personnes appartenant à ces groupes de feed targeting Facebook sont plus susceptibles de voir cette publication ; les autres le sont moins mais peuvent la voir malgré tout. Utilisez targeting (voir ci-dessus) si vous souhaitez garantir la restriction. Champs démographiques disponibles pour feedTargeting :

ageMin : limitez l’âge minimum qui peut voir les publications. Valeur entière égale ou supérieure à 13. La valeur par défaut est 0.
ageMax : limitez l’âge maximum qui peut voir les publications. Valeur entière égale ou inférieure à 65.
countries : également appelé geo targeting, vous pouvez indiquer les pays qui doivent pouvoir voir la publication. Tableau de codes pays.
collegeYears : ciblez l’âge de fin d’études supérieures pour voir la publication. Tableau d’entiers pour l’année d’obtention du diplôme d’études supérieures.
educationStatuses : ciblez le statut d’éducation. Tableau d’entiers pour le ciblage par niveau d’études. Utilisez 1 pour lycée, 2 pour undergraduate et 3 pour alumnus.
genders : ciblez le sexe pour voir la publication. Tableau d’entiers pour cibler des sexes spécifiques. 1 cible tous les hommes et 2 toutes les femmes. Par défaut, les deux sont ciblés.
relationshipStatuses : ciblez le statut relationnel. Tableau d’entiers pour cibler selon le statut relationnel. Utilisez 1 pour célibataire, 2 pour « en couple », 3 pour marié et 4 pour fiancé. Par défaut, tous les types sont inclus.

Facebook Feed Targeting

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

Texte alternatif

Ajoutez du texte alternatif Facebook, également appelé alt text, à une image ou une vidéo. L’alt text Facebook est une fonctionnalité d’accessibilité utilisée pour fournir des informations supplémentaires aux utilisateurs et aux lecteurs d’écran. Utilisez altText dans l’objet faceBookOptions.

Facebook Alt Text

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

Chaque alt text doit correspondre à une image ou vidéo du tableau mediaUrls. L’alt text est appliqué à chaque image dans l’ordre.

Miniature vidéo

Définissez une miniature vidéo Facebook (image de couverture). Envoyez une URL distante d’un fichier PNG ou JPG des mêmes dimensions que la vidéo et de moins de 10 Mo. L’URL doit se terminer par .png ou .jpg.

Example Facebook Video Thumbnail

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

Titre de vidéo

Ajoutez un titre à la vidéo Facebook avec le paramètre title.

Facebook Video Title

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

GIFs animés

Une seule URL mediaUrls est autorisée dans le tableau lors de la publication d’un GIF animé sur Facebook. Si l’URL du média ne se termine pas par « .gif » ou « .GIF », définissez le champ isVideo sur true.

Facebook Animated GIF

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

Mentions de Pages Facebook

Vous pouvez mentionner une autre Page Facebook, ce qu’on appelle aussi Facebook mentions ou Facebook tagging, en incluant le nom de la Page Facebook ou l’ID de la Page dans le texte de la publication. Facebook n’autorise pas les mentions ou les tags de profils personnels ou de groupes. Incluez une mention avec le @mention suivant : @page-name ou @[page-id]

Mention avec le nom de la Page

Un exemple de texte de publication avec un nom de Page. Vous trouverez le nom de la Page dans l’URL Facebook, par ex. https://www.facebook.com/Ayrshare

Facebook Page Mention with Page Name

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

Ayrshare fera de son mieux pour trouver la Page correspondante à partir du nom, mais parfois aucune correspondance n’est trouvée. Une méthode plus fiable consiste à utiliser un ID de Page.

Mention avec l’ID de Page

Un exemple de texte de publication avec un ID de Page ; notez l’utilisation de []. Voir ci-dessous comment trouver l’ID de la Page.

Facebook Page Mention with Page ID

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

L’ID de Page Facebook se résoudra en Page correspondante et notifiera la Page mentionnée.

Utilisez la mention de Page avec précaution, en ne mentionnant que des Pages auxquelles vous êtes associé. Prenez garde à ne jamais spammer.Lorsque vous mentionnez une Page, le propriétaire de la Page est notifié par une alerte et un e-mail. Si plusieurs Pages se plaignent que vous les mentionnez, Facebook peut bannir votre compte. En général, mentionnez uniquement des Pages avec lesquelles vous avez une relation établie.La Page Facebook mentionnée doit autoriser les autres Pages à la mentionner / la taguer. Les mentions peuvent être activées dans les paramètres généraux de la Page, sous « Others Tag this Page ».Consultez les règles importantes concernant les mentions.

Trouver un ID de Page Facebook

Point de terminaison Brand

Vous pouvez rechercher soit un utilisateur Facebook, soit une Page Facebook à l’aide des points de terminaison Brand.

Sur Facebook.com

Depuis le fil d’actualité Facebook, cliquez sur Pages dans le menu de gauche.
Cliquez sur le nom de votre Page pour vous y rendre.
Cliquez sur About en haut de votre Page. Si vous ne le voyez pas, cliquez sur More▼.
Faites défiler pour trouver votre Page ID sous MORE INFO.

ou si vous voulez trouver l’ID d’une page dont vous n’êtes pas propriétaire :

Si la Page Facebook a une URL telle que https://www.facebook.com/ayrshare-1234567890, l’ID est 1234567890.
Si la Page Facebook a une URL telle que :

https://www.facebook.com/pages/ayrshare/123466789203, alors l’ID de la Page est le nombre à la fin, tel que 123466789203. Vous pouvez vérifier que l’ID de Page est correct en accédant à https://facebook.com/page-id, l’URL se résoudra vers la Page. Vous pouvez aussi essayer un outil tiers de recherche d’ID de Page Facebook, non pris en charge par Ayrshare, comme : https://lookup-id.com/ Si toutes les autres méthodes échouent, vous pouvez aller sur la page Facebook dans un navigateur et afficher la source de la page. Dans Chrome, cliquez avec le bouton droit et sélectionnez « View Source ». Recherchez ensuite soit owning_profile_id soit profile_id pour trouver l’ID de la Page.

Consultez les règles importantes concernant les mentions.

Activer les mentions de Page

La Page doit autoriser les mentions et les tags dans les publications et commentaires. Par défaut, cela est activé, mais vous pouvez vérifier en vous connectant sur facebook.com et en basculant sur votre Page.

En vue de votre Page, cliquez sur l’image de profil de votre page dans le coin supérieur droit.
Cliquez sur Settings & Privacy -> Settings.
Dans le menu Settings, cliquez sur Privacy.
Cliquez sur Page and Tagging.
Faites défiler jusqu’à Reviewing.
Basculez les paramètres pour autoriser les tags et mentions.

Meta Business Suite

Brouillons de publication

Créez une publication Facebook brouillon qui apparaîtra dans l’onglet Meta Business Suite Draft. Les brouillons de publication Facebook sont des publications que vous avez commencé à rédiger mais que vous n’avez pas encore publiées. Vous pouvez enregistrer des brouillons pour y revenir plus tard, ou les planifier pour une publication ultérieure. Ajoutez le paramètre draft à faceBookOptions pour envoyer la publication en tant que brouillon. Disponible pour les publications texte, images, vidéo et reels.

Facebook Draft Post

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

Heure de publication planifiée

Définissez une heure de publication planifiée pour les publications Facebook qui apparaîtront dans l’onglet Meta Business Suite Scheduled Posts. Les publications planifiées Facebook sont des publications que vous avez créées et planifiées pour être diffusées à une date ultérieure, gérées dans le Meta Business Suite. Cela peut être utile pour planifier vos publications sur les réseaux sociaux à l’avance, ou pour publier à des moments où vous savez que votre audience est la plus active. Disponible pour les publications texte, images, vidéo et reels.

L’heure de publication doit être supérieure à 10 minutes après l’heure actuelle et se situer dans les 29 jours suivant la date du jour.Sauf si vous devez gérer les publications Facebook dans Meta Business Suite, nous recommandons d’utiliser la date de planification standard.

Ajoutez le paramètre scheduledPublishDate à faceBookOptions pour planifier une heure de publication.

Facebook Scheduled Post

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

Aperçu de lien

Une publication Facebook créera automatiquement un aperçu d’un lien inclus dans le corps de la publication. Cependant, si vous souhaitez spécifier un autre lien ou forcer l’aperçu du lien, utilisez le paramètre link avec l’URL du lien.

Facebook Link Preview

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

Si un champ mediaUrls est inclus dans la requête de publication, le média sera affiché à la place de l’aperçu du lien.

Facebook Ads

Les Facebook Ads sont un moyen de promouvoir vos publications auprès d’un public plus large.

Facebook Ads

Limites de caractères

Consultez Facebook Character Limits pour plus d’informations.

Informations complémentaires

Comment ajouter des sauts de ligne ou du texte enrichi à une publication Facebook ?

Les sauts de ligne Facebook peuvent être ajoutés à une publication avec un caractère de nouvelle ligne spécial. Le texte enrichi, tel que le gras ou l’italique, peut être ajouté à une publication Facebook avec quelques éléments HTML.

Pourquoi je vois « Published by Ayrshare » sur une publication ?

Pas d’inquiétude, cela n’apparaît que dans la vue admin. Consultez le guide de dépannage pour plus d’informations.

​Publier sur Facebook

​Carrousel d’images

​Facebook Reels

​Facebook Stories

​Légendes des médias

​Marquage de lieu

​Ciblage d’audience

​Targeting

​Feed Targeting

​Texte alternatif

​Miniature vidéo

​Titre de vidéo

​GIFs animés

​Mentions de Pages Facebook

​Mention avec le nom de la Page

​Mention avec l’ID de Page

​Trouver un ID de Page Facebook

​Point de terminaison Brand

​Sur Facebook.com

​Activer les mentions de Page

​Meta Business Suite

​Brouillons de publication

​Heure de publication planifiée

​Aperçu de lien

​Facebook Ads

Facebook Ads

​Limites de caractères

​Informations complémentaires

​Comment ajouter des sauts de ligne ou du texte enrichi à une publication Facebook ?

​Pourquoi je vois « Published by Ayrshare » sur une publication ?

Publier sur Facebook

Carrousel d’images

Facebook Reels

Facebook Stories

Légendes des médias

Marquage de lieu

Ciblage d’audience

Targeting

Feed Targeting

Texte alternatif

Miniature vidéo

Titre de vidéo

GIFs animés

Mentions de Pages Facebook

Mention avec le nom de la Page

Mention avec l’ID de Page

Trouver un ID de Page Facebook

Point de terminaison Brand

Sur Facebook.com

Activer les mentions de Page

Meta Business Suite

Brouillons de publication

Heure de publication planifiée

Aperçu de lien

Facebook Ads

Limites de caractères

Informations complémentaires

Comment ajouter des sauts de ligne ou du texte enrichi à une publication Facebook ?

Pourquoi je vois « Published by Ayrshare » sur une publication ?