Facebook Page API

​

Публікація у 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 автоматично покаже попередній перегляд посилання в дописі, якщо не додано зображення або відео. У наведеному вище прикладі буде показано зображення. Видалення зображення призведе до появи попереднього перегляду посилання.
• Якщо ваше відео не закінчується відомим розширенням, наприклад mp4, використайте параметр isVideo. Деталі див. в ендпоінті /post.
• Facebook також підтримує надсилання медіа без тексту допису. Якщо ви не хочете включати текст допису, надішліть порожній рядок post: "".
• Див. Facebook Media Guidelines і Facebook Authorization для отримання додаткової інформації.

​

Каруселі зображень

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

• Параметр link верхнього рівня — це URL наприкінці каруселі.
• items — це масив об’єктів, які містять наведені нижче значення. Мінімум 2 і максимум 10 елементів у масиві items.
• picture — URL карусельного зображення.
• link — URL, на який відкривається при кліку на зображення.
• name — (необов’язково) зображення, що відображається на кожній картці зображення.

​

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: установіть у true, щоб опублікувати відео як Reels. Обов’язково, якщо ви хочете публікувати у Facebook Reels.
• title: заголовок відео з максимумом 255 символів. Значення понад 255 символів буде обрізано. Необов’язково.
• thumbNail: мініатюра (обкладинка) відео. Мініатюра має бути URL до файлу JPEG або PNG. Розмір мініатюри має бути меншим за 10 МБ. Необов’язково.

{
  "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 не підтримують текст допису — будь-який текст, наданий у полі post, включно з згадуваннями, буде проігноровано.
• Фото або відео, завантажене для сторіс, не могло бути використане в раніше опублікованому дописі.
• Відео-сторіс не може перевищувати 60 секунд.
• Увімкніть Stories Archive, щоб мати змогу отримувати сторіс через GET.

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

​

Підписи до медіа

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

​

Позначки локації

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

​

Таргетування аудиторії

1. Facebook Targeting: дозволяє визначати аудиторію вашого допису за такими факторами, як вік, стать, місце розташування та стосунки. Установивши ці параметри, ви можете гарантувати, що ваш допис буде показано лише людям, які відповідають зазначеним критеріям.
2. Facebook Feed Targeting: ця опція дозволяє додатково уточнити видимість вашого допису в стрічках новин цільової аудиторії.

​

Таргетування

• ageMin: обмежити мінімальний вік для перегляду дописів. Прийнятні значення: 13, 15, 18, 21 або 25. Інші значення віку буде відхилено.
• countries: також відоме як геофенсинг, ви можете обмежити країни, у яких можна переглядати допис. Масив кодів країн. Максимальна кількість країн, які можна таргетувати, становить 25. Якщо потрібно таргетувати понад 25 країн або обмежити певні країни, див. Facebook Page Country Restrictions.

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

​

Feed Targeting

• ageMin: обмежити мінімальний вік для перегляду дописів. Ціле значення 13 або вище. Типово — 0.
• ageMax: обмежити максимальний вік для перегляду дописів. Ціле значення 65 або нижче.
• countries: також відоме як гео-таргетування, ви можете вказати країни, у яких повинен переглядатися допис. Масив кодів країн.
• collegeYears: таргетувати вік випуску коледжу для перегляду допису. Масив цілих чисел для року випуску з коледжу.
• educationStatuses: таргетувати освітній статус для перегляду допису. Масив цілих чисел для таргетування на основі рівня освіти. Використайте 1 для середньої школи, 2 для бакалаврату та 3 для випускника.
• genders: таргетувати стать для перегляду допису. Масив цілих чисел для таргетування конкретних статей. 1 таргетує всіх чоловіків-глядачів, а 2 — жінок. Типово таргетуються обидві.
• relationshipStatuses: таргетувати сімейний стан для перегляду допису. Масив цілих чисел для таргетування на основі сімейного стану. Використайте 1 для одиноких, 2 для «у стосунках», 3 для одружених та 4 для заручених. Типово — усі типи.

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

​

Альтернативний текст

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

​

Мініатюра відео

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

​

Заголовок відео

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

​

Анімовані 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"]
}

​

Згадування Facebook-сторінок

​

Згадування з назвою сторінки

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

​

Згадування з Page ID

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

​

Знайти Facebook Page ID

​

Brand-ендпоінт

​

На Facebook.com

1. У стрічці новин Facebook натисніть Pages у лівому бічному меню.
2. Натисніть на назву вашої Page, щоб перейти до неї.
3. Натисніть About у верхній частині вашої Page. Якщо ви не бачите цього, натисніть More▼.
4. Прокрутіть донизу, щоб знайти ваш Page ID під MORE INFO.

• Якщо Facebook Page має URL, наприклад https://www.facebook.com/ayrshare-1234567890, то ID — це 1234567890.
• Якщо Facebook Page має URL, наприклад:

​

Увімкнення згадувань Page

1. Переглядаючи як вашу Page, натисніть зображення профілю сторінки у правому верхньому куті.
2. Натисніть Settings & Privacy -> Settings.
3. У меню Settings натисніть Privacy.
4. Натисніть Page and Tagging.
5. Прокрутіть донизу до Reviewing.
6. Перемкніть налаштування, щоб дозволити позначення та згадування.

​

Meta Business Suite

​

Чернетки дописів

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

​

Розкладний час публікації

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

​

Попередній перегляд посилання

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

​

Facebook Ads

​

Обмеження символів

​

Додаткова інформація

​

Як додати розриви рядків або форматований текст до допису Facebook?

​

Чому я бачу «Published by Ayrshare» на дописі?