Campagne a pagamento sui tuoi account pubblicitari collegati, con un’unica API
Collega un account pubblicitario una volta sola e FoPost dialoga con ogni rete per te. Trasforma in inserzione un post che va bene, gestisci l’albero delle campagne, metti in pausa ciò che non funziona e ottieni le metriche in un unico formato, qualunque sia la rete che pubblica l’inserzione.
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"
}
}Sponsorizza un post
Promuovi un post già pubblicato, senza rifare il creativo.
Parte in pausa
Le nuove inserzioni vengono create in pausa, a meno che tu non passi paused: false.
Un unico formato di metriche
Impression, copertura, clic, spesa, CTR e lead, uguali su ogni rete.
Le reti pubblicitarie che il tuo team usa già
Gli account pubblicitari di Meta, Google, LinkedIn, TikTok, Pinterest e X si collegano tramite l’accesso di ciascuna rete. GET /v1/ads/providers elenca ogni rete con ciò che supporta, e la sponsorizzazione funziona per i post pubblicati su Facebook, Instagram, LinkedIn, TikTok, Pinterest e X. Google non ha un post da promuovere, quindi le sue inserzioni si creano anziché sponsorizzarsi.
Leggi il riferimento delle connessioni
Funzionalità per rete
Ogni provider indica se offre sponsorizzazione, moduli lead, pixel e altro.
Anche le inserzioni esistenti
GET /v1/ads/external elenca le inserzioni create nel gestore della rete.
Limitato al workspace
Una connessione appartiene a un workspace ed è raggiungibile solo da lì.
Campagne, gruppi di inserzioni, inserzioni, creativi e pubblici
Quando una sponsorizzazione non basta, costruisci l’albero completo: POST /v1/ads/campaigns, /v1/ads/ad-sets e /v1/ads/ads, con creativi e pubblici salvati. Gli obiettivi coprono interazioni, traffico, notorietà, visualizzazioni video, messaggi, chiamate, WhatsApp e vendite, per quanto ciascuna rete li supporti. Metti in pausa o riattiva fino a 50 oggetti con una sola chiamata.
Vedi gli endpoint delle campagnecurl -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 }
]
}Duplica
Copia una campagna, un gruppo di inserzioni o un’inserzione. Le copie partono in pausa per impostazione predefinita.
Pubblici
Crea pubblici salvati e cerca le opzioni di targeting offerte da una rete.
La spesa richiede publish
Lanciare, sponsorizzare, mettere in pausa o eliminare richiede lo scope publish.
Leggi i risultati senza imparare ogni API di reporting
GET /v1/ads/insights accetta un ID oggetto e un intervallo di date e restituisce totali, una suddivisione facoltativa per età, genere, posizionamento o paese e una timeline giornaliera. La spesa è nella valuta dell’account pubblicitario, in sottounità. Per Google Ads, POST /v1/ads/insights/query esegue una query Google Ads sul cliente collegato.
Leggi il riferimento delle metrichecurl "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": []
}
}Qualsiasi intervallo di date
since e until nel fuso orario dell’account pubblicitario; aggiungi daily=true per una timeline.
Aggiorna un’inserzione
POST /v1/ads/:id/refresh recupera lo stato attuale e i numeri complessivi.
Sottounità
Budget e spesa sono interi nella più piccola unità della valuta.
Lead, commenti alle inserzioni e tracciamento delle conversioni
Crea moduli lead su Meta e LinkedIn e leggi i lead raccolti da ciascun modulo. Iscrivi una Pagina e i suoi nuovi lead arrivano in GET /v1/ads/leads man mano che la rete li segnala. Su TikTok leggi i commenti sotto un’inserzione e rispondi o nascondili. Gestisci i pixel su Meta, LinkedIn e TikTok e rimanda gli eventi di conversione alla rete.
Inizia a sviluppare
Feed dei lead
Un unico elenco paginato dei lead di tutte le Pagine iscritte.
Commenti alle inserzioni
POST /v1/ads/comments/:id/reply e /hide sulle inserzioni TikTok.
Pixel
Crea e condividi un pixel e leggine statistiche e qualità di corrispondenza.
API Ads: le risposte alle tue domande
Quali reti pubblicitarie sono supportate?
Una chiamata API può avviare una spesa?
Chi paga le inserzioni?
Posso gestire inserzioni create altrove?
Di quali scope della chiave API ho bisogno?
C’è un limite di frequenza?
Sviluppa oggi con API Ads
Iniziare è gratis e l'API completa è inclusa. Crea una chiave e fai la tua prima chiamata in pochi minuti.
Ottieni la tua chiave API