Des campagnes payantes sur vos comptes publicitaires connectés, via une seule API
Connectez un compte publicitaire une fois et FoPost dialogue avec chaque réseau pour vous. Transformez une publication qui fonctionne bien en publicité, gérez l’arborescence des campagnes, mettez en pause ce qui ne marche pas et récupérez les statistiques sous un format unique, quel que soit le réseau qui diffuse la publicité.
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"
}
}Booster une publication
Promouvez une publication déjà publiée, sans refaire le visuel.
Démarre en pause
Les nouvelles publicités sont créées en pause, sauf si vous passez paused: false.
Un seul format de statistiques
Impressions, portée, clics, dépenses, CTR et leads, identiques sur chaque réseau.
Les réseaux publicitaires que votre équipe utilise déjà
Les comptes publicitaires Meta, Google, LinkedIn, TikTok, Pinterest et X se connectent via la connexion propre à chaque réseau. GET /v1/ads/providers liste chaque réseau avec ce qu’il prend en charge, et le boost fonctionne pour les publications Facebook, Instagram, LinkedIn, TikTok, Pinterest et X. Google n’a pas de publication à promouvoir : ses publicités sont donc créées plutôt que boostées.
Lire la référence des connexions
Capacités par réseau
Chaque fournisseur indique s’il propose le boost, les formulaires de leads, les pixels, etc.
Les publicités existantes aussi
GET /v1/ads/external liste les publicités créées dans le gestionnaire propre du réseau.
Limité à l’espace de travail
Une connexion appartient à un espace de travail et n’est accessible que depuis celui-ci.
Campagnes, ensembles de publicités, publicités, créations et audiences
Quand un boost ne suffit pas, construisez l’arborescence complète : POST /v1/ads/campaigns, /v1/ads/ad-sets et /v1/ads/ads, avec créations et audiences enregistrées. Les objectifs couvrent l’engagement, le trafic, la notoriété, les vues vidéo, les messages, les appels, WhatsApp et les ventes, dans la mesure où chaque réseau les propose. Mettez en pause ou relancez jusqu’à 50 objets en un seul appel.
Voir les endpoints des campagnescurl -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 }
]
}Dupliquer
Copiez une campagne, un ensemble de publicités ou une publicité. Les copies démarrent en pause par défaut.
Audiences
Créez des audiences enregistrées et recherchez les options de ciblage d’un réseau.
Les dépenses exigent publish
Lancer, booster, mettre en pause ou supprimer nécessite la portée publish.
Lisez les résultats sans apprendre chaque API de reporting
GET /v1/ads/insights prend un identifiant d’objet et une plage de dates, et renvoie des totaux, une ventilation facultative par âge, genre, emplacement ou pays, et une chronologie quotidienne. Les dépenses sont dans la devise du compte publicitaire, en unités mineures. Pour Google Ads, POST /v1/ads/insights/query exécute une requête Google Ads sur le client connecté.
Lire la référence des statistiquescurl "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": []
}
}Toute plage de dates
since et until dans le fuseau horaire du compte publicitaire ; ajoutez daily=true pour une chronologie.
Actualiser une publicité
POST /v1/ads/:id/refresh récupère le statut actuel et les chiffres cumulés.
Unités mineures
Budgets et dépenses sont des entiers dans la plus petite unité de la devise.
Leads, commentaires de publicités et suivi des conversions
Créez des formulaires de leads sur Meta et LinkedIn et lisez les leads collectés par chaque formulaire. Abonnez une Page et ses nouveaux leads arrivent dans GET /v1/ads/leads au fil des remontées du réseau. Sur TikTok, lisez les commentaires sous une publicité, répondez-y ou masquez-les. Gérez les pixels sur Meta, LinkedIn et TikTok, et renvoyez des événements de conversion au réseau.
Commencer à développer
Flux de leads
Une liste paginée de leads de toutes les Pages abonnées.
Commentaires de publicités
POST /v1/ads/comments/:id/reply et /hide sur les publicités TikTok.
Pixels
Créez et partagez un pixel, et consultez ses statistiques et sa qualité de correspondance.
API Ads : vos questions, nos réponses
Quels réseaux publicitaires sont pris en charge ?
Un appel d’API peut-il déclencher des dépenses ?
Qui paie les publicités ?
Puis-je gérer des publicités créées ailleurs ?
De quelles portées de clé d’API ai-je besoin ?
Y a-t-il une limite de débit ?
Développez avec API Ads dès aujourd'hui
Le démarrage est gratuit et l'API complète est incluse. Créez une clé et faites votre premier appel en quelques minutes.
Obtenir votre clé d’API