API de Facebook Page

​

Publicar en 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 mostrará automáticamente una previsualización del enlace en la publicación salvo que se incluya una imagen o video. En el ejemplo anterior se mostrará la imagen. Si se elimina la imagen, se mostrará la previsualización del enlace.
• Si tu video no termina en una extensión de video conocida como mp4, usa el parámetro isVideo. Consulta el endpoint /post para más detalles.
• Facebook también admite el envío de medios sin texto en la publicación. Si no quieres incluir texto, envía una cadena vacía post: "".
• Consulta las pautas de medios de Facebook y la autorización de Facebook para más información.

​

Carrusel de imágenes

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

• El parámetro link de nivel superior es la URL al final del carrusel.
• items es un array de objetos con los siguientes valores. Mínimo 2 elementos y máximo 10 elementos en el array items.
• picture - URL de la imagen del carrusel.
• link - URL a la que se accede al hacer clic en la imagen.
• name - (opcional) texto que se muestra en cada tarjeta de imagen.

​

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: establece en true para publicar el video en Reels. Obligatorio si quieres publicar en Facebook Reels.
• title: el título del video con un máximo de 255 caracteres. Todo lo que supere los 255 caracteres se truncará. Opcional.
• thumbNail: la miniatura (imagen de portada) del video. La miniatura debe ser una URL a un archivo JPEG o PNG. Debe pesar menos de 10MB. Opcional.

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

• Las Stories de Facebook no admiten texto en la publicación; cualquier texto del campo post, incluidas las menciones, será ignorado.
• Una foto o video subido para una Story no puede haber sido utilizado en una publicación publicada previamente.
• Una Story de video no puede superar los 60 segundos.
• Activa el Archivo de Stories para poder recuperar Stories con GET.

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

​

Pies de foto de medios

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

​

Etiquetado de ubicación

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

​

Segmentación de audiencia

1. Facebook Targeting: te permite definir la audiencia de tu publicación en función de factores como edad, género, ubicación y relación. Al establecer estos parámetros, puedes asegurarte de que la publicación solo se muestre a personas que cumplan los criterios especificados.
2. Facebook Feed Targeting: esta opción permite refinar aún más la visibilidad de tu publicación en los News Feeds de tu audiencia segmentada.

​

Targeting

• ageMin: limita la edad mínima que puede ver las publicaciones. Valores aceptados: 13, 15, 18, 21 o 25. Otras edades se rechazarán.
• countries: también conocido como geofencing, permite limitar los países que pueden ver la publicación. Array de códigos de país. El número máximo de países que se pueden segmentar es 25. Si necesitas segmentar más de 25 países o restringir ciertos países, consulta Facebook Page Country Restrictions.

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

​

Feed Targeting

• ageMin: limita la edad mínima que puede ver las publicaciones. Valor entero 13 o superior. Por defecto, 0.
• ageMax: limita la edad máxima que puede ver las publicaciones. Valor entero 65 o inferior.
• countries: también conocido como geo targeting; permite indicar los países que deberían poder ver la publicación. Array de códigos de país.
• collegeYears: segmenta la edad de graduación universitaria. Array de enteros con el año de graduación de la universidad.
• educationStatuses: segmenta según el nivel educativo. Array de enteros para segmentar por nivel educativo. Usa 1 para high school, 2 para undergraduate y 3 para alum.
• genders: segmenta por género. Array de enteros para segmentar géneros específicos. 1 segmenta a los espectadores masculinos y 2 a las femeninas. Por defecto, se segmenta a ambos.
• relationshipStatuses: segmenta según el estado sentimental. Array de enteros para segmentar por estado sentimental. Usa 1 para soltero, 2 para ‘en una relación’, 3 para casado y 4 para comprometido. Por defecto, todos los tipos.

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

​

Texto alternativo

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

​

Miniatura de video

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

​

Título del video

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

​

GIFs animados

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

​

Menciones de Facebook Pages

​

Mención con nombre de Page

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

​

Mención con Page ID

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

​

Encontrar un Facebook Page ID

​

Endpoint Brand

​

En Facebook.com

1. Desde el News Feed de Facebook, haz clic en Pages en el menú lateral izquierdo.
2. Haz clic en el nombre de tu Page para ir a tu Page.
3. Haz clic en About en la parte superior de tu Page. Si no lo ves, haz clic en More▼.
4. Desplázate para encontrar tu Page ID debajo de MORE INFO.

• Si la Facebook Page tiene una URL como https://www.facebook.com/ayrshare-1234567890, el ID es 1234567890.
• Si la Facebook Page tiene una URL como:

​

Activar menciones de Page

1. Viendo como tu Page, haz clic en la imagen de perfil de tu Page en la esquina superior derecha.
2. Haz clic en Settings & Privacy -> Settings.
3. En el menú Settings, haz clic en Privacy.
4. Haz clic en Page and Tagging.
5. Desplázate hasta Reviewing.
6. Cambia las opciones para permitir etiquetas y menciones.

​

Meta Business Suite

​

Publicaciones en borrador

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

​

Programar la hora de publicación

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

​

Previsualización de enlaces

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

​

Facebook Ads

​

Límites de caracteres

​

Información adicional

​

¿Cómo añado saltos de línea o texto enriquecido a una publicación de Facebook?

​

¿Por qué veo “Published by Ayrshare” en una publicación?