Ad account fields — Facebook API

Ad Account

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

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

Thông tin MỘT tài khoản quảng cáo: tên, trạng thái (đang chạy / bị vô hiệu / nợ), tiền tệ, múi giờ, tổng đã chi, số dư cần thanh toán, giới hạn chi tiêu, ngân sách ngày tối thiểu, nguồn thanh toán (thẻ, mã ưu đãi). Dùng để kiểm tài khoản còn chạy được không trước khi đọc số liệu, biết tiền tệ / múi giờ để hiểu đúng spend và ngày của insight — 360 dùng để cảnh báo tài khoản bị khóa / chưa thanh toán.

Đường dẫn có act_<id> nên 360 tự chọn đúng token tài khoản đó — không cần gửi platform_shop_id. Tài khoản chưa nối với brand → 360 trả 404, không gọi Meta.
Mọi số tiền dạng chuỗi số, đơn vị nhỏ nhất của tiền tệ tài khoản. VND không có xu → số đồng (amount_spent: "2004940757" = 2.004.940.757 đ).
BẪY: coupons[].amount lại nhân 100 kể cả với VND — gọi thật thấy amount: 5457900 với display_amount: "54.579 ₫ (VND)". Dùng display_amount hoặc chia 100.
balance là nợ chờ thanh toán, KHÔNG phải tiền nạp còn lại; tài khoản trả sau bằng thẻ thường có balance nhỏ và về 0 sau mỗi lần trừ thẻ.
Thiếu fields → 360 trả 400 (tham số bắt buộc). Trường không có ở loại đối tượng → Meta báo (#100) Tried accessing nonexisting field ….

Request

Endpoint

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

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	Phiên bản Graph API.
account_id	path	string	Yes	5924809560908319	Id tài khoản quảng cáo (số, KHÔNG có act_ — 360 ghép thành `act_<id>`). Phải là tài khoản brand đã nối với 360, khác → 404.
fields	query	string	Yes	id,account_id,name,account_status,disable_reason,currency,timezone_name,timezone_offset_hours_utc,amount_spent,balance,spend_cap,min_daily_budget,business_name,created_time,funding_source_details	Trường cần lấy, cách nhau dấu phẩy. Không gửi = chỉ `id`, `account_id`.

Request examples

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/act_5924809560908319?fields=id%2Caccount_id%2Cname%2Caccount_status%2Cdisable_reason%2Ccurrency%2Ctimezone_name%2Camount_spent%2Cbalance%2Cspend_cap%2Cmin_daily_budget" \
  -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",
    params={
        "fields": "id,account_id,name,account_status,disable_reason,currency,timezone_name,amount_spent,balance,spend_cap,min_daily_budget"
    },
    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');
for (const [k, v] of Object.entries({"fields":"id,account_id,name,account_status,disable_reason,currency,timezone_name,amount_spent,balance,spend_cap,min_daily_budget"})) 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' . '?' . http_build_query(['fields' => 'id,account_id,name,account_status,disable_reason,currency,timezone_name,amount_spent,balance,spend_cap,min_daily_budget']);
$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
id	string	act_5924809560908319	Id dạng `act_<id>`.
account_id	string	5924809560908319	Id dạng số.
name	string		Tên tài khoản.
account_status	int	1	`1` hoạt động · `2` vô hiệu · `3` chưa thanh toán · `7` chờ xét rủi ro · `8` chờ quyết toán · `9` ân hạn · `100` chờ đóng · `101` đã đóng.
disable_reason	int	0	`0` = không bị vô hiệu; khác 0 = lý do Meta khóa tài khoản (đi kèm `account_status = 2`).
currency	string	VND	Tiền tệ của MỌI số tiền trong tài khoản (ngân sách, chi tiêu, insight).
timezone_name / timezone_offset_hours_utc	string / int	Asia/Ho_Chi_Minh / 7	Múi giờ tài khoản — ngày của insight (`date_start`, `date_stop`) tính theo múi giờ này.
amount_spent	string	2004940757	Tổng đã chi từ khi tạo tài khoản (hoặc từ lần đặt lại giới hạn chi tiêu), đơn vị nhỏ nhất của tiền tệ — VND: số đồng.
balance	string	1678231	Số tiền đã chi nhưng CHƯA thanh toán (sẽ trừ vào thẻ ở lần lập hóa đơn tới), cùng đơn vị.
spend_cap	string	0	Giới hạn chi tiêu tài khoản; `"0"` = không đặt giới hạn.
min_daily_budget	int	26085	Ngân sách ngày tối thiểu Meta chấp nhận cho tài khoản (đơn vị nhỏ nhất).
business_name	string		Tên doanh nghiệp gắn với tài khoản.
created_time	string	2023-03-02T09:59:47+0700	ISO 8601 theo múi giờ tài khoản.
funding_source_details	object		Nguồn thanh toán.
id	string
display_string	string	VISA *6580	Thẻ (đã che số).
type	int	1	`1` = thẻ tín dụng / ghi nợ.
coupons	object[]		Mã ưu đãi quảng cáo còn hạn: `{amount, currency, display_amount, start_date, expiration, coupon_id, original_amount}` — xem ghi chú đơn vị.

Response sample

{
  "id": "act_5924809560908319",
  "account_id": "5924809560908319",
  "name": "CÔNG TY MẪU",
  "account_status": 1,
  "disable_reason": 0,
  "currency": "VND",
  "timezone_name": "Asia/Ho_Chi_Minh",
  "timezone_offset_hours_utc": 7,
  "amount_spent": "2004940757",
  "balance": "1678231",
  "spend_cap": "0",
  "business_name": "CÔNG TY MẪU",
  "created_time": "2023-03-02T09:59:47+0700",
  "min_daily_budget": 26085,
  "funding_source_details": {
    "id": "8939081906204912",
    "coupons": [
      {
        "amount": 0,
        "currency": "VND",
        "display_amount": "0 ₫ (VND)",
        "expiration": "2027-03-23T03:45:41+0000",
        "start_date": "2026-09-21T15:45:41+0000",
        "coupon_id": "28872567062429776",
        "original_amount": 144200,
        "original_display_amount": "1.442 ₫ (VND)"
      }
    ],
    "display_string": "VISA *6580",
    "type": 1
  }
}

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