حملات مدفوعة على حساباتك الإعلانية المرتبطة، عبر واجهة API واحدة
اربط حساباً إعلانياً مرة واحدة ويتولى FoPost التعامل مع كل شبكة نيابة عنك. حوّل المنشور الناجح إلى إعلان، وأدر هيكل الحملة، وأوقف ما لا يحقق نتائج، واسحب الإحصاءات بصيغة واحدة أياً كانت الشبكة التي تعرض الإعلان.
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"
}
}عزّز منشوراً
روّج لمنشور نشرته بالفعل دون إعادة بناء المحتوى الإعلاني.
يبدأ متوقفاً
تُنشأ الإعلانات الجديدة متوقفة مؤقتاً ما لم تمرّر paused: false.
صيغة إحصاءات واحدة
مرات الظهور والوصول والنقرات والإنفاق وCTR والعملاء المحتملون، بالصيغة نفسها على كل شبكة.
شبكات الإعلانات التي يستخدمها فريقك بالفعل
تُربط حسابات Meta وGoogle وLinkedIn وTikTok وPinterest وX الإعلانية عبر تسجيل الدخول الخاص بكل شبكة. يعرض GET /v1/ads/providers كل شبكة وما تدعمه، والتعزيز يعمل للمنشورات المنشورة على Facebook وInstagram وLinkedIn وTikTok وPinterest وX. لا يوجد في Google منشور للترويج له، لذا تُبنى إعلاناته ولا تُعزَّز.
اقرأ مرجع الربط
إمكانات كل شبكة
يوضح كل مزوّد ما إذا كان يتيح التعزيز ونماذج العملاء المحتملين وبكسلات التتبع وغيرها.
الإعلانات القائمة أيضاً
يعرض GET /v1/ads/external الإعلانات المنشأة في مدير الإعلانات الخاص بالشبكة.
ضمن مساحة العمل
الربط يخص مساحة عمل واحدة ولا يمكن الوصول إليه إلا منها.
الحملات والمجموعات الإعلانية والإعلانات والمحتوى الإعلاني والجماهير
عندما لا يكفي التعزيز، ابنِ الهيكل الكامل: POST /v1/ads/campaigns و/v1/ads/ad-sets و/v1/ads/ads، مع المحتوى الإعلاني والجماهير المحفوظة. تشمل الأهداف التفاعل والزيارات والوعي ومشاهدات الفيديو والرسائل والمكالمات وWhatsApp والمبيعات، بقدر ما تدعمها كل شبكة. أوقف أو استأنف حتى 50 كائناً في استدعاء واحد.
اطّلع على نقاط نهاية الحملاتcurl -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 }
]
}نسخ
انسخ حملة أو مجموعة إعلانية أو إعلاناً. تبدأ النسخ متوقفة افتراضياً.
الجماهير
أنشئ جماهير محفوظة وابحث في خيارات الاستهداف التي تتيحها الشبكة.
الإنفاق يتطلب publish
الإطلاق أو التعزيز أو الإيقاف أو الحذف يتطلب نطاق publish.
اقرأ النتائج دون تعلّم كل واجهة تقارير
يأخذ GET /v1/ads/insights معرّف كائن ونطاقاً زمنياً ويعيد الإجماليات، وتفصيلاً اختيارياً حسب العمر أو الجنس أو موضع العرض أو البلد، وخطاً زمنياً يومياً. الإنفاق بعملة الحساب الإعلاني وبأصغر وحدة. وفي Google Ads، ينفّذ POST /v1/ads/insights/query استعلام Google Ads على العميل المرتبط.
اقرأ مرجع الإحصاءاتcurl "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": []
}
}أي نطاق زمني
since وuntil بالمنطقة الزمنية للحساب الإعلاني؛ أضف daily=true للحصول على خط زمني.
حدّث إعلاناً
يسحب POST /v1/ads/:id/refresh الحالة الحالية والأرقام الإجمالية.
أصغر وحدة
الميزانيات والإنفاق أعداد صحيحة بأصغر وحدة للعملة.
العملاء المحتملون وتعليقات الإعلانات وتتبع التحويلات
أنشئ نماذج عملاء محتملين على Meta وLinkedIn واقرأ العملاء الذين يجمعهم كل نموذج. اشترك في صفحة وستصل عملاؤها المحتملون الجدد إلى GET /v1/ads/leads بمجرد إبلاغ الشبكة بهم. وعلى TikTok، اقرأ التعليقات تحت الإعلان وردّ عليها أو أخفها. أدر البكسلات على Meta وLinkedIn وTikTok وأرسل أحداث التحويل إلى الشبكة.
ابدأ البناء
موجز العملاء المحتملين
قائمة واحدة مقسّمة إلى صفحات للعملاء المحتملين من كل صفحة مشترك بها.
تعليقات الإعلانات
POST /v1/ads/comments/:id/reply و/hide لإعلانات TikTok.
البكسلات
أنشئ بكسلاً وشاركه واقرأ إحصاءاته وجودة المطابقة.
أسئلة حول واجهة API للإعلانات، مع إجاباتها
ما شبكات الإعلانات المدعومة؟
هل سيبدأ استدعاء API في إنفاق المال؟
من يدفع تكلفة الإعلانات؟
هل يمكنني إدارة إعلانات أنشأتها في مكان آخر؟
ما نطاقات مفتاح API التي أحتاجها؟
هل هناك حد للطلبات؟
ابنِ على واجهة API للإعلانات اليوم
البداية مجانية وواجهة API كاملة مُضمَّنة. أنشئ مفتاحًا ونفّذ أول طلب خلال دقائق.
احصل على مفتاح API