Chiến dịch trả phí trên các tài khoản quảng cáo đã kết nối, qua một API
Kết nối tài khoản quảng cáo một lần và FoPost giao tiếp với từng mạng thay bạn. Biến bài viết hiệu quả thành quảng cáo, quản lý cây chiến dịch, tạm dừng phần không hiệu quả và lấy số liệu theo một định dạng duy nhất, bất kể mạng nào chạy quảng cáo.
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"
}
}Đẩy một bài viết
Quảng bá bài bạn đã đăng mà không phải dựng lại creative.
Bắt đầu ở trạng thái tạm dừng
Quảng cáo mới được tạo ở trạng thái tạm dừng trừ khi bạn truyền paused: false.
Một định dạng số liệu
Lượt hiển thị, lượt tiếp cận, lượt nhấp, chi tiêu, CTR và lead, giống nhau trên mọi mạng.
Các mạng quảng cáo đội của bạn đã dùng
Tài khoản quảng cáo Meta, Google, LinkedIn, TikTok, Pinterest và X kết nối qua đăng nhập riêng của từng mạng. GET /v1/ads/providers liệt kê từng mạng cùng những gì mạng đó hỗ trợ, và việc đẩy bài hoạt động với bài đăng trên Facebook, Instagram, LinkedIn, TikTok, Pinterest và X. Google không có bài viết để quảng bá, nên quảng cáo của Google được tạo chứ không phải đẩy.
Đọc tài liệu tham chiếu kết nối
Khả năng theo từng mạng
Mỗi nhà cung cấp cho biết có hỗ trợ đẩy bài, biểu mẫu lead, pixel và hơn thế nữa hay không.
Cả quảng cáo hiện có
GET /v1/ads/external liệt kê quảng cáo được tạo trong trình quản lý riêng của mạng.
Giới hạn theo workspace
Một kết nối thuộc về một workspace và chỉ truy cập được từ workspace đó.
Chiến dịch, nhóm quảng cáo, quảng cáo, creative và tệp đối tượng
Khi đẩy bài chưa đủ, hãy xây cả cây: POST /v1/ads/campaigns, /v1/ads/ad-sets và /v1/ads/ads, kèm creative và tệp đối tượng đã lưu. Mục tiêu gồm tương tác, lưu lượng, nhận biết, lượt xem video, tin nhắn, cuộc gọi, WhatsApp và doanh số, tùy mức mỗi mạng hỗ trợ. Tạm dừng hoặc tiếp tục tối đa 50 đối tượng trong một lệnh gọi.
Xem các endpoint chiến dịchcurl -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 }
]
}Nhân bản
Sao chép một chiến dịch, nhóm quảng cáo hoặc quảng cáo. Bản sao mặc định ở trạng thái tạm dừng.
Tệp đối tượng
Tạo tệp đối tượng đã lưu và tìm các tùy chọn nhắm mục tiêu mà mạng cung cấp.
Chi tiêu cần publish
Khởi chạy, đẩy bài, tạm dừng hoặc xóa đều cần scope publish.
Đọc kết quả mà không phải học từng API báo cáo
GET /v1/ads/insights nhận một id đối tượng và một khoảng ngày, rồi trả về tổng số, phân tích tùy chọn theo độ tuổi, giới tính, vị trí hiển thị hoặc quốc gia, và dòng thời gian theo ngày. Chi tiêu tính bằng tiền tệ của tài khoản quảng cáo, theo đơn vị nhỏ nhất. Với Google Ads, POST /v1/ads/insights/query chạy truy vấn Google Ads trên khách hàng đã kết nối.
Đọc tài liệu tham chiếu số liệucurl "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": []
}
}Mọi khoảng ngày
since và until theo múi giờ của tài khoản quảng cáo; thêm daily=true để có dòng thời gian.
Làm mới một quảng cáo
POST /v1/ads/:id/refresh lấy trạng thái hiện tại và số liệu trọn đời.
Đơn vị nhỏ nhất
Ngân sách và chi tiêu là số nguyên theo đơn vị tiền tệ nhỏ nhất.
Lead, bình luận quảng cáo và theo dõi chuyển đổi
Tạo biểu mẫu lead trên Meta và LinkedIn rồi đọc các lead mà mỗi biểu mẫu thu được. Đăng ký một Page và lead mới sẽ xuất hiện trong GET /v1/ads/leads khi mạng báo về. Trên TikTok, đọc bình luận dưới một quảng cáo rồi trả lời hoặc ẩn chúng. Quản lý pixel trên Meta, LinkedIn và TikTok, và gửi sự kiện chuyển đổi ngược lại cho mạng.
Bắt đầu xây dựng
Luồng lead
Một danh sách lead phân trang cho mọi Page đã đăng ký.
Bình luận quảng cáo
POST /v1/ads/comments/:id/reply và /hide trên quảng cáo TikTok.
Pixel
Tạo, chia sẻ và đọc thống kê cùng chất lượng khớp của một pixel.
Giải đáp câu hỏi về Ads API
Hỗ trợ những mạng quảng cáo nào?
Một lệnh gọi API có bắt đầu tiêu tiền không?
Ai trả tiền quảng cáo?
Tôi có thể quản lý quảng cáo đã tạo ở nơi khác không?
Tôi cần những scope API key nào?
Có giới hạn tốc độ không?
Xây dựng trên Ads API ngay hôm nay
Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.
Lấy API key của bạn