Bezahlte Kampagnen auf Ihren verbundenen Werbekonten, über eine API
Verbinden Sie ein Werbekonto einmal, und FoPost spricht für Sie mit jedem Netzwerk. Machen Sie einen gut laufenden Beitrag zur Anzeige, verwalten Sie den Kampagnenbaum, pausieren Sie, was nicht funktioniert, und rufen Sie Insights in einem einheitlichen Format ab, egal welches Netzwerk die Anzeige ausspielt.
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"
}
}Beitrag bewerben
Bewerben Sie einen bereits veröffentlichten Beitrag, ohne das Creative neu zu bauen.
Startet pausiert
Neue Anzeigen werden pausiert erstellt, es sei denn, Sie übergeben paused: false.
Ein Insights-Format
Impressionen, Reichweite, Klicks, Ausgaben, CTR und Leads, in jedem Netzwerk gleich.
Die Werbenetzwerke, die Ihr Team bereits nutzt
Werbekonten von Meta, Google, LinkedIn, TikTok, Pinterest und X werden über den jeweiligen Netzwerk-Login verbunden. GET /v1/ads/providers listet jedes Netzwerk mit seinen unterstützten Funktionen, und das Bewerben funktioniert für Beiträge auf Facebook, Instagram, LinkedIn, TikTok, Pinterest und X. Google hat keinen Beitrag zum Bewerben, daher werden dessen Anzeigen erstellt statt beworben.
Verbindungen-Referenz lesen
Funktionen pro Netzwerk
Jeder Anbieter gibt an, ob er Bewerben, Lead-Formulare, Pixel und mehr bietet.
Auch bestehende Anzeigen
GET /v1/ads/external listet Anzeigen auf, die im eigenen Manager des Netzwerks erstellt wurden.
Auf den Workspace begrenzt
Eine Verbindung gehört zu einem Workspace und ist nur von dort aus erreichbar.
Kampagnen, Anzeigengruppen, Anzeigen, Creatives und Zielgruppen
Reicht ein Boost nicht, bauen Sie den ganzen Baum: POST /v1/ads/campaigns, /v1/ads/ad-sets und /v1/ads/ads, dazu Creatives und gespeicherte Zielgruppen. Die Ziele umfassen Interaktion, Traffic, Bekanntheit, Videoaufrufe, Nachrichten, Anrufe, WhatsApp und Verkäufe, soweit das jeweilige Netzwerk sie anbietet. Pausieren oder aktivieren Sie bis zu 50 Objekte in einem Aufruf.
Kampagnen-Endpunkte ansehencurl -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 }
]
}Duplizieren
Kopieren Sie eine Kampagne, Anzeigengruppe oder Anzeige. Kopien starten standardmäßig pausiert.
Zielgruppen
Erstellen Sie gespeicherte Zielgruppen und durchsuchen Sie die Targeting-Optionen eines Netzwerks.
Ausgaben erfordern publish
Starten, Bewerben, Pausieren oder Löschen erfordert den Scope publish.
Ergebnisse lesen, ohne jede Reporting-API zu lernen
GET /v1/ads/insights nimmt eine Objekt-ID und einen Zeitraum und liefert Summen, eine optionale Aufschlüsselung nach Alter, Geschlecht, Platzierung oder Land sowie eine tägliche Zeitleiste. Die Ausgaben stehen in der Währung des Werbekontos, in Untereinheiten. Für Google Ads führt POST /v1/ads/insights/query eine Google-Ads-Abfrage für den verbundenen Kunden aus.
Insights-Referenz lesencurl "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": []
}
}Beliebiger Zeitraum
since und until in der Zeitzone des Werbekontos; fügen Sie daily=true für eine Zeitleiste hinzu.
Eine Anzeige aktualisieren
POST /v1/ads/:id/refresh ruft den aktuellen Status und die Gesamtwerte ab.
Untereinheiten
Budgets und Ausgaben sind Ganzzahlen in der kleinsten Währungseinheit.
Leads, Anzeigenkommentare und Conversion-Tracking
Erstellen Sie Lead-Formulare auf Meta und LinkedIn und lesen Sie die Leads, die jedes Formular sammelt. Abonnieren Sie eine Seite, und ihre neuen Leads erscheinen in GET /v1/ads/leads, sobald das Netzwerk sie meldet. Auf TikTok lesen Sie die Kommentare unter einer Anzeige und antworten darauf oder blenden sie aus. Verwalten Sie Pixel auf Meta, LinkedIn und TikTok und senden Sie Conversion-Events ans Netzwerk zurück.
Jetzt loslegen
Leads-Feed
Eine paginierte Liste der Leads über alle abonnierten Seiten.
Anzeigenkommentare
POST /v1/ads/comments/:id/reply und /hide bei TikTok-Anzeigen.
Pixel
Erstellen und teilen Sie Pixel und lesen Sie Statistiken und Abgleichsqualität.
Fragen zu Ads-API, beantwortet
Welche Werbenetzwerke werden unterstützt?
Löst ein API-Aufruf Ausgaben aus?
Wer bezahlt die Anzeigen?
Kann ich Anzeigen verwalten, die ich anderswo erstellt habe?
Welche API-Schlüssel-Scopes benötige ich?
Gibt es ein Rate-Limit?
Baue noch heute auf Ads-API
Der Start ist kostenlos und die vollständige API inklusive. Erstelle einen Schlüssel und mach in wenigen Minuten deinen ersten Aufruf.
API-Schlüssel erhalten