Betaalde campagnes op je gekoppelde advertentieaccounts, via één API
Koppel een advertentieaccount één keer en FoPost praat voor je met elk netwerk. Maak van een post die goed presteert een advertentie, beheer de campagneboom, pauzeer wat niet werkt en haal inzichten op in één vorm, welk netwerk de advertentie ook draait.
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"
}
}Boost een post
Promoot een post die je al hebt gepubliceerd, zonder de creative opnieuw op te bouwen.
Start gepauzeerd
Nieuwe advertenties worden gepauzeerd aangemaakt, tenzij je paused: false meegeeft.
Eén vorm voor inzichten
Vertoningen, bereik, klikken, uitgaven, CTR en leads, op elk netwerk hetzelfde.
De advertentienetwerken die je team al gebruikt
Advertentieaccounts van Meta, Google, LinkedIn, TikTok, Pinterest en X koppel je via de eigen login van elk netwerk. GET /v1/ads/providers toont elk netwerk met wat het ondersteunt, en boosten werkt voor posts die zijn gepubliceerd op Facebook, Instagram, LinkedIn, TikTok, Pinterest en X. Google heeft geen post om te promoten, dus daar worden advertenties gebouwd in plaats van geboost.
Lees de naslag over koppelingen
Mogelijkheden per netwerk
Elke provider geeft aan of hij boosten, leadformulieren, pixels en meer biedt.
Ook bestaande advertenties
GET /v1/ads/external toont advertenties die in de eigen manager van het netwerk zijn gemaakt.
Beperkt tot de workspace
Een koppeling hoort bij één workspace en is alleen daarvandaan bereikbaar.
Campagnes, advertentiesets, advertenties, creatives en doelgroepen
Als een boost niet genoeg is, bouw dan de volledige boom: POST /v1/ads/campaigns, /v1/ads/ad-sets en /v1/ads/ads, met creatives en opgeslagen doelgroepen erbij. Doelen omvatten engagement, verkeer, bereik, videoweergaven, berichten, gesprekken, WhatsApp en verkoop, voor zover elk netwerk ze ondersteunt. Pauzeer of hervat tot 50 objecten in één aanroep.
Bekijk de campagne-endpointscurl -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 }
]
}Dupliceren
Kopieer een campagne, advertentieset of advertentie. Kopieën starten standaard gepauzeerd.
Doelgroepen
Maak opgeslagen doelgroepen en doorzoek de targetingopties van een netwerk.
Uitgaven vereisen publish
Lanceren, boosten, pauzeren of verwijderen vereist de scope publish.
Lees resultaten zonder elke rapportage-API te leren
GET /v1/ads/insights neemt een object-id en een periode en geeft totalen terug, optioneel een uitsplitsing naar leeftijd, geslacht, plaatsing of land, en een dagelijkse tijdlijn. Uitgaven staan in de valuta van het advertentieaccount, in kleinste eenheden. Voor Google Ads voert POST /v1/ads/insights/query een Google Ads-query uit op de gekoppelde klant.
Lees de naslag over inzichtencurl "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": []
}
}Elke periode
since en until in de tijdzone van het advertentieaccount; voeg daily=true toe voor een tijdlijn.
Ververs een advertentie
POST /v1/ads/:id/refresh haalt de actuele status en de totalen sinds de start op.
Kleinste eenheden
Budgetten en uitgaven zijn gehele getallen in de kleinste valuta-eenheid.
Leads, advertentiereacties en conversietracking
Maak leadformulieren op Meta en LinkedIn en lees de leads die elk formulier verzamelt. Abonneer je op een Pagina en de nieuwe leads verschijnen in GET /v1/ads/leads zodra het netwerk ze meldt. Op TikTok lees je de reacties onder een advertentie en beantwoord of verberg je ze. Beheer pixels op Meta, LinkedIn en TikTok en stuur conversie-events terug naar het netwerk.
Begin met bouwen
Leadfeed
Eén gepagineerde lijst met leads van alle geabonneerde Pagina's.
Advertentiereacties
POST /v1/ads/comments/:id/reply en /hide op TikTok-advertenties.
Pixels
Maak en deel een pixel, en lees de statistieken en matchkwaliteit.
Vragen over Ads API, beantwoord
Welke advertentienetwerken worden ondersteund?
Gaat een API-aanroep geld uitgeven?
Wie betaalt voor de advertenties?
Kan ik advertenties beheren die ik elders heb gemaakt?
Welke API-sleutelscopes heb ik nodig?
Is er een rate limit?
Bouw vandaag nog op de Ads API
Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.
Vraag je API-sleutel aan