> ## 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.
# Impulsar publicación
> Impulsa una publicación enviándola a la plataforma de anuncios de Facebook
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
}
;
};
export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
API Key of the Primary Profile.
Format: Authorization: Bearer API_KEY
{!noProfileKey && (profileKeyRequired ?
Profile Key of a User Profile.
Format: Profile-Key: PROFILE_KEY
:
Profile Key of a User Profile.
Format: Profile-Key: PROFILE_KEY
)}
;
Impulsa una publicación existente de Facebook para crear un anuncio.
Este endpoint te permite convertir tus publicaciones orgánicas en anuncios pagos con parámetros personalizados de segmentación, presupuesto y programación.
- Los montos de presupuesto y de puja deben especificarse en USD con hasta dos decimales.
- El anuncio debe ejecutarse durante al menos 30 horas para cumplir con el requisito de Facebook.
-
Puedes usar el [endpoint de intereses](/apis/ads/facebook/get-ad-interests) para encontrar los IDs de intereses
para la segmentación.
- Facebook puede tardar hasta 24 horas en revisar y aprobar las publicaciones impulsadas.
-
Si usas `fbPostId` directamente (en lugar del `postId` de Ayrshare), asegúrate de que sea un ID de publicación
de Facebook válido.
### Objetivos del anuncio
Cada anuncio debe tener un objetivo. El objetivo determina cómo se optimizará el anuncio para su visualización.
-
`engagement`: Este objetivo busca aumentar la interacción, asegurando al mismo tiempo que el anuncio llegue al
mayor número de usuarios únicos. Equilibra la visibilidad con la interacción, mostrando el anuncio a tantas
personas diferentes como sea posible que puedan interactuar con él.
-
`interactions`: Diseñado para aumentar interacciones, como me gusta, comentarios y compartidos, en el anuncio.
Facebook prioriza mostrar el anuncio a los usuarios con mayor probabilidad de interactuar con él.
-
`awareness_views`: Se enfoca en aumentar el reconocimiento de marca maximizando la cantidad de veces que se
muestra el anuncio. Prioriza mostrar el anuncio tantas veces como sea posible dentro del presupuesto,
independientemente del alcance único.
-
`awareness_audience`: Busca aumentar el reconocimiento de marca maximizando la cantidad de personas únicas
que ven el anuncio. Garantiza que el anuncio llegue a la mayor cantidad de usuarios diferentes posibles y maximiza
el tamaño de la audiencia única en lugar de mostrarlo varias veces a la misma audiencia.
Aprende más sobre cómo integrar la Facebook Marketing API con Ayrshare en nuestra [Guía de integración con la Facebook Marketing API](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/).
## Parámetros del encabezado
## Parámetros del cuerpo
El ID de la cuenta publicitaria de Facebook en la que se impulsará la publicación. El ID de la cuenta puede recuperarse desde el
[endpoint de cuentas publicitarias](/apis/ads/facebook/get-ad-accounts).
Nombre para tu anuncio (aparece en el Administrador de Anuncios de Facebook) con el formato `{adName} - {postId o fbPostId} - {fecha actual}`.
Monto máximo de puja en USD. El monto mínimo de puja es \$1.00.
Presupuesto diario en USD. El presupuesto mínimo es \$1.00.
El [ID de publicación social de Facebook](/apis/overview#social-post-id) de la publicación a impulsar, que te permite
crear un anuncio a partir de una publicación creada directamente en Facebook. Este es el ID de la [publicación en
Facebook](/apis/history/history-platform), no de Ayrshare. Requerido si `postId` no está establecido.
El objetivo del anuncio. Valores: `engagement`, `interactions`, `awareness_views` y
`awareness_audience`. Consulta los [detalles de los objetivos del anuncio](/apis/ads/facebook/boost-post#ad-goals) arriba para
más información.
Ubicaciones objetivo del anuncio con un objeto de arreglos: `countries`, `regions`, `cities`.
Lista de códigos de país.
```json theme={"system"}
{
"countries": ["US", "CA"]
}
```
Las regiones requieren el valor `key` de la región de Facebook. Consulta el [endpoint de regiones](/apis/ads/facebook/get-ad-regions) para más información.
```json theme={"system"}
{
"regions": [{ "key": "3886" }]
}
```
Las ciudades requieren: `key` (de Facebook), `radius` y `distance_unit`.
`radius` es la distancia alrededor de la ciudad: 10–50 millas o 17–80 kilómetros.
`distance_unit` es `mile` o `kilometer`.
Consulta el [endpoint de ciudades](/apis/ads/facebook/get-ad-cities) para más información.
```json theme={"system"}
{
"cities": [
{ "key": "2420605", "radius": 25, "distance_unit": "mile" }
]
}
```
El [ID de publicación de Ayrshare](/apis/overview#ayrshare-post-id) de la publicación a impulsar. Requerido si
`fbPostId` no está establecido.
El estado del anuncio. Valores: `active` y `paused`.
Más adelante puedes cambiar el estado del anuncio usando el [endpoint de actualización de anuncio](/apis/ads/facebook/put-ad-update).
Controla la compartición de presupuesto entre conjuntos de anuncios a nivel de campaña de Meta.
Meta ahora requiere este campo en cada campaña creada sin un presupuesto a nivel de campaña, por lo que Ayrshare siempre lo envía — con valor predeterminado `false` por compatibilidad hacia atrás.
Establécelo en `true` para permitir que Meta comparta hasta aproximadamente el 20% del presupuesto de un conjunto de anuncios entre otros conjuntos de anuncios de la misma campaña para optimizar el rendimiento general. Consulta la [referencia del ad campaign group](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/) de Meta para más detalles.
Realiza el seguimiento del anuncio usando un Facebook Pixel.
El ID del Facebook Pixel para hacer seguimiento del anuncio.
```json theme={"system"}
{
"pixelId": 1234567890
}
```
Agrega etiquetas UTM a la URL del anuncio.
```json theme={"system"}
{
"urlTags": ["utm_source=ayrshare", "utm_medium=social", "utm_campaign=ayrshare-social"]
}
```
Por ejemplo, si la URL de enlace es `https://www.mysite.com/my-post` y las etiquetas de URL agregadas son:
`utm_source=ayrshare`, `utm_medium=social` y `utm_campaign=ayrshare-social`.
La URL del anuncio será:
`https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social`.
Meta requiere que los anunciantes en [categorías especiales de anuncios](https://www.facebook.com/business/help/298000447747885?helpref=faq_content) se auto-identifiquen con la categoría de su campaña.
Si tu negocio está en una de estas categorías, debes seleccionar la categoría apropiada al impulsar tu publicación.
Se admiten los siguientes valores:
-
`housing`: Anuncios que promuevan o enlacen directamente con una oportunidad de vivienda o servicio relacionado,
incluyendo, entre otros, listados para la venta o alquiler de una casa o apartamento, seguros para propietarios de vivienda,
seguros hipotecarios, préstamos hipotecarios, reparaciones de vivienda y servicios de valoración o crédito con garantía hipotecaria.
-
`financial_product_services`: Anuncios que promuevan o enlacen directamente con una oferta de productos y
servicios financieros, incluido el crédito.
-
`employment`: Anuncios que promuevan o enlacen directamente con una oportunidad de empleo, incluidos, entre otros,
trabajos a tiempo parcial o completo, pasantías o programas de certificación profesional. Los anuncios relacionados
que entran en esta categoría incluyen promociones de bolsas de empleo o ferias, servicios de agregación
o anuncios que detallen los beneficios que una empresa puede ofrecer, independientemente de una oferta de trabajo específica.
-
`issues_elections_politics`: Anuncios realizados por, en nombre de, o sobre un candidato a un cargo público,
una figura política, un partido político o que aboguen por el resultado de una elección a un cargo público.
Esto también incluye anuncios sobre cualquier elección, referéndum o iniciativa electoral, incluidas
las campañas electorales de "Sal a votar". Anuncios regulados como publicidad política o sobre temas
sociales en cualquier lugar donde se publique el anuncio. Si seleccionas temas, elecciones o política,
debes seleccionar el país en el que deseas publicar estos anuncios. Se te exige estar
autorizado para publicar anuncios sobre temas sociales, elecciones o política en el país especificado.
Meta exige que los anunciantes hayan auto-identificado la categoría de su campaña.
Meta utiliza revisores humanos y aprendizaje automático para identificar este tipo de anuncios.
Si nos envías un `specialAdCategory` incorrecto, existe el riesgo de que tus anuncios se pausen hasta que se ajuste la campaña.
Fecha y hora de finalización en formato ISO 8601 (debe ser al menos 30 horas después del inicio), por ejemplo `2025-03-01T00:00:00Z`.
Si no se establece, el anuncio se ejecutará indefinidamente y tendrá fecha de finalización `ongoing`.
Excluye ubicaciones usando un objeto con arreglos de `countries`, `regions` y `cities`.
Lista de códigos de país a excluir.
```json theme={"system"}
{
"countries": ["US", "CA"]
}
```
Las regiones requieren el valor `key` de la región de Facebook. Consulta el [endpoint de regiones](/apis/ads/facebook/get-ad-regions) para más información.
```json theme={"system"}
{
"regions": [{ "key": "3886" }]
}
```
Las ciudades requieren: `key` (de Facebook), `radius` y `distance_unit`.
`radius` es la distancia alrededor de la ciudad: 10–50 millas o 17–80 kilómetros.
`distance_unit` es `mile` o `kilometer`.
Consulta el [endpoint de ciudades](/apis/ads/facebook/get-ad-cities) para más información.
```json theme={"system"}
{
"cities": [
{ "key": "2420605", "radius": 25, "distance_unit": "mile" }
]
}
```
El género de la audiencia. Valores: `all`, `male`, `female`.
Los intereses objetivo del anuncio como un arreglo de [IDs de
intereses](/apis/ads/facebook/get-ad-interests) de Facebook.
Edad máxima para la segmentación del anuncio (predeterminado: 65).
Edad mínima para la segmentación del anuncio (predeterminado: 18).
Fecha y hora de inicio en formato ISO 8601, por ejemplo `2025-03-01T00:00:00Z`.
Si no se establece, el anuncio comenzará inmediatamente.
El beneficiario del anuncio para el cumplimiento de la Ley de Servicios Digitales (DSA) para países de la UE. Debe establecerse
junto con `dsaPayor` si se proporciona alguno de los dos. Por favor, consulta nuestra [guía sobre
DSA](/apis/ads/facebook/get-dsa-recommendations) para más información.
El pagador del anuncio para el cumplimiento de la Ley de Servicios Digitales (DSA) para países de la UE. Debe establecerse
junto con `dsaBeneficiary` si se proporciona alguno de los dos.
```bash cURL theme={"system"}
curl -X POST https://api.ayrshare.com/api/ads/facebook/boost \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{
"postId": "1234567890",
"accountId": "1234567890",
"adName": "My Ad",
"status": "active",
"goal": "engagement",
"minAge": 18,
"maxAge": 65,
"locations": { "countries": ["US"] },
"budget": 100,
"bidAmount": 1,
"startDate": "2025-03-01T00:00:00Z",
"endDate": "2025-03-07T23:59:59Z",
"interests": [1234567890, 1234567891]
}'
```
```javascript JavaScript theme={"system"}
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/boost", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${API_KEY}`
},
body: JSON.stringify({
postId: "1234567890",
accountId: "1234567890",
adName: "My Ad",
status: "active",
goal: "engagement",
minAge: 18,
maxAge: 65,
locations: { countries: ["US"] },
budget: 100,
bidAmount: 1,
startDate: "2025-03-01T00:00:00Z",
endDate: "2025-03-07T23:59:59Z",
interests: [1234567890, 1234567891]
})
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
```
```python Python theme={"system"}
import requests
API_KEY = "API_KEY"
url = "https://api.ayrshare.com/api/ads/facebook/boost"
payload = {
"postId": "1234567890",
"accountId": "1234567890",
"adName": "My Ad",
"status": "active",
"goal": "engagement",
"minAge": 18,
"maxAge": 65,
"locations": {"countries": ["US"]},
"budget": 100,
"bidAmount": 1,
"startDate": "2025-03-01T00:00:00Z",
"endDate": "2025-03-07T23:59:59Z",
"interests": [1234567890, 1234567891]
}
response = requests.post(url, headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}, json=payload)
print(response.json())
```
```php PHP theme={"system"}
"1234567890",
"accountId" => "1234567890",
"adName" => "My Ad",
"status" => "active",
"goal" => "engagement",
"minAge" => 18,
"maxAge" => 65,
"locations" => ["countries" => ["US"]],
"budget" => 100,
"bidAmount" => 1,
"startDate" => "2025-03-01T00:00:00Z",
"endDate" => "2025-03-07T23:59:59Z",
"interests" => [1234567890, 1234567891]
];
$ch = curl_init("https://api.ayrshare.com/api/ads/facebook/boost");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Content-Type: application/json",
"Authorization: Bearer " . $API_KEY
]);
$response = curl_exec($ch);
$result = json_decode($response, true);
print_r($result);
curl_close($ch);
```
```csharp C# theme={"system"}
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
string API_KEY = "API_KEY";
var payload = new
{
postId = "1234567890",
accountId = "1234567890",
adName = "My Ad",
status = "active",
goal = "engagement",
minAge = 18,
maxAge = 65,
locations = new { countries = new[] { "US" } },
budget = 100,
bidAmount = 1,
startDate = "2025-03-01T00:00:00Z",
endDate = "2025-03-07T23:59:59Z",
interests = new[] { 1234567890, 1234567891 }
};
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", API_KEY);
var content = new StringContent(
JsonSerializer.Serialize(payload),
Encoding.UTF8,
"application/json"
);
var response = await client.PostAsync("https://api.ayrshare.com/api/ads/facebook/boost", content);
var responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
}
```
```go Go theme={"system"}
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
apiKey := "API_KEY"
payload := map[string]interface{}{
"postId": "1234567890",
"accountId": "1234567890",
"adName": "My Ad",
"status": "active",
"goal": "engagement",
"minAge": 18,
"maxAge": 65,
"locations": map[string]interface{}{"countries": []string{"US"}},
"budget": 100,
"bidAmount": 1,
"startDate": "2025-03-01T00:00:00Z",
"endDate": "2025-03-07T23:59:59Z",
"interests": []int{1234567890, 1234567891},
}
jsonData, err := json.Marshal(payload)
if err != nil {
fmt.Println("Error marshaling JSON:", err)
return
}
req, err := http.NewRequest("POST", "https://api.ayrshare.com/api/ads/facebook/boost", bytes.NewBuffer(jsonData))
if err != nil {
fmt.Println("Error creating request:", err)
return
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer "+apiKey)
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error sending request:", err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("Error reading response:", err)
return
}
fmt.Println(string(body))
}
```
```java Java theme={"system"}
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;
import com.fasterxml.jackson.databind.ObjectMapper;
public class BoostPost {
public static void main(String[] args) {
String API_KEY = "API_KEY";
String url = "https://api.ayrshare.com/api/ads/facebook/boost";
Map payload = new HashMap<>();
payload.put("postId", "1234567890");
payload.put("accountId", "1234567890");
payload.put("adName", "My Ad");
payload.put("status", "active");
payload.put("goal", "engagement");
payload.put("minAge", 18);
payload.put("maxAge", 65);
Map locations = new HashMap<>();
locations.put("countries", Arrays.asList("US"));
payload.put("locations", locations);
payload.put("budget", 100);
payload.put("bidAmount", 1);
payload.put("startDate", "2025-03-01T00:00:00Z");
payload.put("endDate", "2025-03-07T23:59:59Z");
payload.put("interests", Arrays.asList(1234567890, 1234567891));
try {
ObjectMapper objectMapper = new ObjectMapper();
String requestBody = objectMapper.writeValueAsString(payload);
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer " + API_KEY)
.POST(HttpRequest.BodyPublishers.ofString(requestBody))
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (IOException | InterruptedException e) {
e.printStackTrace();
}
}
}
```
```ruby Ruby theme={"system"}
require 'net/http'
require 'uri'
require 'json'
API_KEY = "API_KEY"
uri = URI.parse("https://api.ayrshare.com/api/ads/facebook/boost")
payload = {
postId: "1234567890",
accountId: "1234567890",
adName: "My Ad",
status: "active",
goal: "engagement",
minAge: 18,
maxAge: 65,
locations: { countries: ["US"] },
budget: 100,
bidAmount: 1,
startDate: "2025-03-01T00:00:00Z",
endDate: "2025-03-07T23:59:59Z",
interests: [1234567890, 1234567891]
}
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri.request_uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer #{API_KEY}"
request.body = payload.to_json
response = http.request(request)
puts response.body
```
```json 200: Publicación impulsada theme={"system"}
{
"status": "success",
"adId": "120217670757750410",
"adName": "API Post - DE6gpw8kxlonHy2b7Lo - 2025-03-26T23:42:43",
"adStatus": "active",
"bidAmount": 10,
"budget": 100,
"endDate": "2026-03-28T22:30:00Z",
"goal": {
"title": "Get More Engagement",
"description": "This goal seeks to increase engagement...",
"type": "engagement"
},
"interests": [
"6003195554098"
],
"locations": { "countries": ["US"] },
"maxAge": 65,
"minAge": 18,
"postId": "DE6gpw8kxlonHy2b7Lo",
"startDate": "2026-03-26T22:30:00Z"
}
```
```json 400: ID de cuenta inválido theme={"system"}
{
"action": "boost post",
"status": "error",
"code": 369,
"message": "Unable to boost post. Please try again or contact us if the issue persists.",
"details": "The accountId likely does not exist. Please check the accountId and try again."
}
```
```json 400: Faltan parámetros requeridos theme={"system"}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "Missing required fields: budget"
}
```