Bağlı reklam hesaplarınızda ücretli kampanyalar, tek bir API ile
Bir reklam hesabını bir kez bağlayın, FoPost sizin yerinize her ağla konuşsun. İyi performans gösteren bir gönderiyi reklama çevirin, kampanya ağacını yönetin, çalışmayanı duraklatın ve reklamı hangi ağ yürütürse yürütsün içgörüleri tek biçimde çekin.
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"
}
}Gönderiyi öne çıkarın
Yayınladığınız bir gönderiyi, kreatifi yeniden kurmadan tanıtın.
Duraklatılmış başlar
paused: false göndermediğiniz sürece yeni reklamlar duraklatılmış oluşturulur.
Tek içgörü biçimi
Gösterim, erişim, tıklama, harcama, CTR ve potansiyel müşteriler; her ağda aynı.
Ekibinizin zaten kullandığı reklam ağları
Meta, Google, LinkedIn, TikTok, Pinterest ve X reklam hesapları, her ağın kendi girişiyle bağlanır. GET /v1/ads/providers her ağı desteklediği özelliklerle listeler; öne çıkarma Facebook, Instagram, LinkedIn, TikTok, Pinterest ve X'te yayınlanan gönderilerde çalışır. Google'da tanıtılacak gönderi yoktur, bu yüzden reklamları öne çıkarılmaz, oluşturulur.
Bağlantılar referansını okuyun
Ağ bazında yetenekler
Her sağlayıcı öne çıkarma, potansiyel müşteri formları, piksel ve daha fazlasını sunup sunmadığını belirtir.
Mevcut reklamlar da
GET /v1/ads/external, ağın kendi yöneticisinde oluşturulmuş reklamları listeler.
Çalışma alanına bağlı
Bir bağlantı tek bir çalışma alanına aittir ve yalnızca oradan erişilebilir.
Kampanyalar, reklam setleri, reklamlar, kreatifler ve kitleler
Öne çıkarma yetmediğinde tüm ağacı oluşturun: POST /v1/ads/campaigns, /v1/ads/ad-sets ve /v1/ads/ads; yanında kreatifler ve kayıtlı kitleler. Hedefler, her ağın desteklediği ölçüde etkileşim, trafik, bilinirlik, video izlenmesi, mesaj, arama, WhatsApp ve satışı kapsar. Tek çağrıda en fazla 50 nesneyi duraklatın veya devam ettirin.
Kampanya endpoint'lerine bakıncurl -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 }
]
}Çoğaltın
Bir kampanyayı, reklam setini veya reklamı kopyalayın. Kopyalar varsayılan olarak duraklatılmış başlar.
Kitleler
Kayıtlı kitleler oluşturun ve bir ağın sunduğu hedefleme seçeneklerinde arama yapın.
Harcama için publish gerekir
Başlatma, öne çıkarma, duraklatma veya silme publish kapsamını gerektirir.
Her raporlama API'sini öğrenmeden sonuçları okuyun
GET /v1/ads/insights bir nesne kimliği ve tarih aralığı alır; toplamları, isteğe bağlı yaş, cinsiyet, yerleşim veya ülke kırılımını ve günlük bir zaman çizelgesini döndürür. Harcama, reklam hesabının para biriminde ve küçük birimle verilir. Google Ads için POST /v1/ads/insights/query, bağlı müşteri üzerinde bir Google Ads sorgusu çalıştırır.
İçgörüler referansını okuyuncurl "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": []
}
}Herhangi bir tarih aralığı
Reklam hesabının saat diliminde since ve until; zaman çizelgesi için daily=true ekleyin.
Reklamı yenileyin
POST /v1/ads/:id/refresh güncel durumu ve toplam sayıları çeker.
Küçük birimler
Bütçe ve harcama, para biriminin en küçük birimiyle tam sayıdır.
Potansiyel müşteriler, reklam yorumları ve dönüşüm takibi
Meta ve LinkedIn'de potansiyel müşteri formları oluşturun ve her formun topladığı kayıtları okuyun. Bir Sayfaya abone olun; yeni potansiyel müşteriler ağ bildirdikçe GET /v1/ads/leads içinde görünür. TikTok'ta bir reklamın altındaki yorumları okuyun, yanıtlayın veya gizleyin. Meta, LinkedIn ve TikTok'ta pikselleri yönetin ve dönüşüm olaylarını ağa geri gönderin.
Geliştirmeye başlayın
Potansiyel müşteri akışı
Abone olunan tüm Sayfalardaki potansiyel müşterilerin tek sayfalanmış listesi.
Reklam yorumları
TikTok reklamlarında POST /v1/ads/comments/:id/reply ve /hide.
Pikseller
Bir piksel oluşturun, paylaşın; istatistiklerini ve eşleşme kalitesini okuyun.
Reklam API'si hakkında sorular ve yanıtlar
Hangi reklam ağları destekleniyor?
Bir API çağrısı para harcamaya başlar mı?
Reklamların parasını kim öder?
Başka yerde oluşturduğum reklamları yönetebilir miyim?
Hangi API anahtarı kapsamlarına ihtiyacım var?
Hız sınırı var mı?
Reklam API'si ile bugün geliştirmeye başlayın
Başlamak ücretsizdir ve eksiksiz API dahildir. Bir anahtar oluşturun ve ilk çağrınızı dakikalar içinde yapın.
API anahtarınızı alın