Minimum daily budgets — Facebook API

Minimum Budgets

GET/{version}/act_{account_id}/minimum_budgetsVia 360: GET https://partner.quantri360.com/v1/facebook/{version}/act_{account_id}/minimum_budgets

Coming soon. This API already runs in production through 360 and pricing is being finalised — you can read the docs and prepare your integration now.

Description

Ngân sách NGÀY tối thiểu của nhóm quảng cáo (chiến dịch đấu giá) theo từng tiền tệ và kiểu tính phí. Dùng để chặn ngân sách quá thấp trước khi tạo / sửa (Meta sẽ từ chối).

Đường dẫn có act_<id> → 360 tự chọn token tài khoản.
Trả mọi tiền tệ — lọc dòng currency = tiền tệ tài khoản (xem GET /act_{account_id} trường currency).
Đơn vị nhỏ nhất của tiền tệ (VND = đồng). Gọi thật VND: min_daily_budget_imp: 26085 khớp min_daily_budget của tài khoản.

Request

Endpoint

GET https://partner.quantri360.com/v1/facebook/{version}/act_{account_id}/minimum_budgets

Authentication & shop

Name	In	Type	Sample	Description
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	act_123456789 hoặc 1234567890	Tài sản Facebook brand đã nối với 360: tài khoản quảng cáo (act_<id> hoặc <id>), Page id hoặc Pixel id — lấy ở GET /v1/platforms. Có thể bỏ khi đường dẫn đã chứa act_<id> / page id của brand.

Request parameters

Name	In	Type	Required	Sample	Description
version	path	string	Yes	v25.0
account_id	path	string	Yes	5924809560908319	Id tài khoản quảng cáo (số, không có act_).
bid_amount	query	int	No	5000	Giá thầu thủ công (đơn vị nhỏ nhất) — trả mức tối thiểu cho kiểu đặt giá thủ công.

Request examples

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/act_5924809560908319/minimum_budgets" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/facebook/v25.0/act_5924809560908319/minimum_budgets",
    params={},
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/facebook/v25.0/act_5924809560908319/minimum_budgets');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/facebook/v25.0/act_5924809560908319/minimum_budgets' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by Facebook)

Name	Type	Sample	Description
data	object[]		Một dòng mỗi tiền tệ (55 tiền tệ, không chỉ tiền tệ tài khoản).
currency	string	VND
min_daily_budget_imp	int	26085	Tính phí theo lượt hiển thị.
min_daily_budget_video_views	int	26085	Tính phí theo lượt xem video.
min_daily_budget_high_freq	int	65212	Sự kiện tối ưu tần suất cao (nhấp, tương tác…).
min_daily_budget_low_freq	int	521690	Sự kiện tần suất thấp (chuyển đổi, cài ứng dụng…).

Response sample

{
  "data": [
    {
      "currency": "USD",
      "min_daily_budget_imp": 100,
      "min_daily_budget_video_views": 100,
      "min_daily_budget_high_freq": 250,
      "min_daily_budget_low_freq": 2000
    },
    {
      "currency": "VND",
      "min_daily_budget_imp": 26085,
      "min_daily_budget_video_views": 26085,
      "min_daily_budget_high_freq": 65212,
      "min_daily_budget_low_freq": 521690
    }
  ]
}

Get started

Sign up for Partner
Enable a data type of the Quảng cáo (Marketing API) group on the platform page
Create an API key (tick the Facebook channel)
Call it as in the examples above