Campañas de pago en tus cuentas publicitarias conectadas, con una sola API
Conecta una cuenta publicitaria una vez y FoPost habla con cada red por ti. Convierte en anuncio una publicación que funciona bien, gestiona el árbol de campañas, pausa lo que no rinde y obtén métricas con el mismo formato, sea cual sea la red que lo publica.
curl -X POST https://api.fopost.com/v1/ads/boost \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "9b2f6c1e-...",
"connectionId": "3f6a9d27-...",
"adAccountId": "act_1234567890",
"postId": "7d3e0a52-...",
"accountId": "4a71d80b-...",
"name": "Boost: launch day",
"goal": "engagement",
"budget": { "minor": 2000, "type": "daily" },
"targeting": { "countries": ["US", "CA"], "ageMin": 25, "ageMax": 54, "gender": "all" }
}'
{
"data": {
"id": "c1d8e4b6-...", "kind": "boost", "name": "Boost: launch day", "goal": "engagement",
"status": "paused", "effectiveStatus": "PAUSED", "platform": "instagram-business",
"sourcePostId": "7d3e0a52-...", "budgetMinor": 2000, "budgetType": "daily",
"currency": "USD", "insights": null, "lastError": null, "createdAt": "2026-11-12T10:04:51Z"
}
}Impulsa una publicación
Promociona una publicación ya publicada, sin rehacer el creativo.
Empieza en pausa
Los anuncios nuevos se crean en pausa salvo que pases paused: false.
Un único formato de métricas
Impresiones, alcance, clics, gasto, CTR y leads, igual en todas las redes.
Las redes publicitarias que tu equipo ya usa
Las cuentas publicitarias de Meta, Google, LinkedIn, TikTok, Pinterest y X se conectan con el inicio de sesión de cada red. GET /v1/ads/providers lista cada red con lo que admite, y el impulso funciona para publicaciones de Facebook, Instagram, LinkedIn, TikTok, Pinterest y X. Google no tiene publicaciones que promocionar, así que sus anuncios se crean en lugar de impulsarse.
Lee la referencia de conexiones
Capacidades por red
Cada proveedor indica si ofrece impulso, formularios de leads, píxeles y más.
También los anuncios existentes
GET /v1/ads/external lista los anuncios creados en el gestor propio de la red.
Limitado al espacio de trabajo
Una conexión pertenece a un espacio de trabajo y solo es accesible desde él.
Campañas, conjuntos de anuncios, anuncios, creativos y audiencias
Cuando un impulso no basta, crea el árbol completo: POST /v1/ads/campaigns, /v1/ads/ad-sets y /v1/ads/ads, con creativos y audiencias guardadas. Los objetivos cubren interacción, tráfico, notoriedad, reproducciones de vídeo, mensajes, llamadas, WhatsApp y ventas, en la medida en que cada red los admita. Pausa o reanuda hasta 50 objetos en una sola llamada.
Consulta los endpoints de campañascurl -X POST https://api.fopost.com/v1/ads/status \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "9b2f6c1e-...",
"connectionId": "3f6a9d27-...",
"status": "paused",
"objects": [
{ "id": "120210000000001", "level": "campaign" },
{ "id": "120210000000042", "level": "ad_set" }
]
}'
{
"data": [
{ "id": "120210000000001", "level": "campaign", "ok": true, "error": null },
{ "id": "120210000000042", "level": "ad_set", "ok": true, "error": null }
]
}Duplicar
Copia una campaña, un conjunto de anuncios o un anuncio. Las copias empiezan en pausa por defecto.
Audiencias
Crea audiencias guardadas y busca las opciones de segmentación que ofrece una red.
Gastar requiere publish
Lanzar, impulsar, pausar o eliminar requiere el permiso publish.
Lee resultados sin aprender cada API de informes
GET /v1/ads/insights recibe un id de objeto y un rango de fechas, y devuelve totales, un desglose opcional por edad, género, ubicación o país, y una cronología diaria. El gasto está en la moneda de la cuenta publicitaria, en unidades menores. Para Google Ads, POST /v1/ads/insights/query ejecuta una consulta de Google Ads sobre el cliente conectado.
Lee la referencia de métricascurl "https://api.fopost.com/v1/ads/insights?workspace_id=9b2f6c1e-...&connection_id=3f6a9d27-...&object_id=120210000000001&since=2026-11-01&until=2026-11-11&breakdown=country" \
-H "X-API-Key: $API_KEY"
{
"data": {
"objectId": "120210000000001", "currency": "USD",
"since": "2026-11-01", "until": "2026-11-11", "breakdownBy": "country",
"totals": { "impressions": 48210, "reach": 31977, "clicks": 1204, "spendMinor": 22000, "ctr": 2.5, "leads": 0 },
"breakdown": [{ "key": "US", "metrics": { "impressions": 39102, "clicks": 1003, ... } }],
"timeline": []
}
}Cualquier rango de fechas
since y until en la zona horaria de la cuenta publicitaria; añade daily=true para una cronología.
Actualiza un anuncio
POST /v1/ads/:id/refresh obtiene el estado actual y las cifras acumuladas.
Unidades menores
Presupuestos y gasto son enteros en la unidad mínima de la moneda.
Leads, comentarios de anuncios y seguimiento de conversiones
Crea formularios de leads en Meta y LinkedIn y lee los leads que recoge cada formulario. Suscribe una Página y sus nuevos leads llegan a GET /v1/ads/leads según los reporta la red. En TikTok, lee los comentarios de un anuncio y responde u oculta. Gestiona píxeles en Meta, LinkedIn y TikTok, y devuelve eventos de conversión a la red.
Empieza a construir
Feed de leads
Una lista paginada de leads de todas las Páginas suscritas.
Comentarios de anuncios
POST /v1/ads/comments/:id/reply y /hide en anuncios de TikTok.
Píxeles
Crea y comparte un píxel, y consulta sus estadísticas y calidad de coincidencia.
Preguntas sobre API de anuncios, respondidas
¿Qué redes publicitarias se admiten?
¿Una llamada a la API empezará a gastar dinero?
¿Quién paga los anuncios?
¿Puedo gestionar anuncios que creé en otro sitio?
¿Qué permisos de clave de API necesito?
¿Hay un límite de solicitudes?
Empieza hoy a construir con la API de anuncios
Empezar es gratis y la API completa está incluida. Crea una clave y haz tu primera llamada en minutos.
Obtén tu clave de API