Pages promotable by the account — Facebook API

Promote Pages

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

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

Trang Facebook dùng được để chạy quảng cáo từ tài khoản này (danh tính hiển thị của quảng cáo). Dùng để chọn page_id khi tạo creative, kiểm tài khoản đã được cấp Trang chưa.

Đường dẫn có act_<id> → 360 tự chọn token tài khoản.
Trang có ở đây chưa chắc đã nối với 360 — đọc bài / tin nhắn của Trang cần nối Trang (gói Facebook Page).

Request

Endpoint

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

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	5999000000000001	Id tài khoản quảng cáo (số, không có act_).
fields	query	string	No	id,name,category	Trường của Trang. Không gửi = `id`, `name`.
limit	query	int	No	25
after	query	string	No		Con trỏ trang kế.

Pagination

Lặp khi có paging.next: thêm after = paging.cursors.after.

Request examples

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/act_5999000000000001/promote_pages?fields=id%2Cname%2Ccategory&limit=25" \
  -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_5999000000000001/promote_pages",
    params={
        "fields": "id,name,category",
        "limit": 25
    },
    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_5999000000000001/promote_pages');
for (const [k, v] of Object.entries({"fields":"id,name,category","limit":25})) 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_5999000000000001/promote_pages' . '?' . http_build_query(['fields' => 'id,name,category', 'limit' => 25]);
$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[]		Trang.
id	string	569900000000001	Id Trang.
name	string	Cửa hàng mẫu
category	string	Thiết kế & Thời trang	Danh mục Trang.
paging	object		`{cursors: {before, after}, next}`.

Response sample

{
  "data": [
    {
      "id": "569900000000001",
      "name": "Cửa hàng mẫu",
      "category": "Thiết kế & Thời trang"
    },
    {
      "id": "879900000000001",
      "name": "Trang mẫu - Online",
      "category": "Thiết kế & Thời trang"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIVGNOVWc5…",
      "after": "QVFIVDllZATB…"
    }
  }
}

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