Saved audiences of an account — Facebook API

Saved Audiences

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

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

Đối tượng đã lưu (bộ nhắm mục tiêu lưu sẵn: tuổi, giới tính, khu vực, sở thích…) của tài khoản kèm quy mô ước tính. Dùng để tái sử dụng nhắm mục tiêu chuẩn của brand khi tạo nhóm quảng cáo.

Đường dẫn có act_<id> → 360 tự chọn token tài khoản.
Thứ tự cũ trước (gọi thật trang đầu có đối tượng từ 2024).

Request

Endpoint

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

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_).
fields	query	string	No	id,name,description,targeting,approximate_count_lower_bound,approximate_count_upper_bound,time_created,time_updated,run_status	Trường cần lấy. Không gửi = chỉ `id`.
filtering	query	string	No		Mảng JSON bộ lọc `{field, operator, value}`.
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_5924809560908319/saved_audiences?fields=id%2Cname%2Ctargeting%2Capproximate_count_lower_bound%2Capproximate_count_upper_bound%2Ctime_updated%2Crun_status&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_5924809560908319/saved_audiences",
    params={
        "fields": "id,name,targeting,approximate_count_lower_bound,approximate_count_upper_bound,time_updated,run_status",
        "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_5924809560908319/saved_audiences');
for (const [k, v] of Object.entries({"fields":"id,name,targeting,approximate_count_lower_bound,approximate_count_upper_bound,time_updated,run_status","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_5924809560908319/saved_audiences' . '?' . http_build_query(['fields' => 'id,name,targeting,approximate_count_lower_bound,approximate_count_upper_bound,time_updated,run_status', '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[]		Đối tượng đã lưu.
id	string	120208800307690254
name	string
description	string
targeting	object		Nhắm mục tiêu đầy đủ — dán thẳng vào `targeting` khi tạo nhóm: `age_min`, `age_max`, `genders`, `geo_locations`, `flexible_spec[{interests, behaviors, work_employers…}]`, `locales`…
approximate_count_lower_bound / approximate_count_upper_bound	int	14700000 / 17300000	Quy mô ước tính (khoảng).
time_created / time_updated	string	2024-05-07T04:21:12+0000	Giờ UTC.
run_status	string	ACTIVE
paging	object		`{cursors: {before, after}, next}`.

Response sample

{
  "data": [
    {
      "id": "120241886757610254",
      "name": "19.03",
      "targeting": {
        "age_max": 48,
        "age_min": 27,
        "flexible_spec": [
          {
            "interests": [
              {
                "id": "6003236917075",
                "name": "H&M (trang phục)"
              },
              {
                "id": "6003346592981",
                "name": "Mua sắm online (bán lẻ)"
              }
            ],
            "work_employers": [
              {
                "id": "33331950906",
                "name": "ZARA"
              }
            ]
          }
        ],
        "genders": [
          2
        ],
        "geo_locations": {
          "countries": [
            "VN"
          ],
          "location_types": [
            "home",
            "recent"
          ]
        },
        "locales": [
          27
        ]
      },
      "approximate_count_lower_bound": 14300000,
      "approximate_count_upper_bound": 16900000,
      "time_created": "2026-03-19T04:47:07+0000",
      "time_updated": "2026-03-19T04:47:07+0000",
      "run_status": "ACTIVE"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MTIwMjA4ODAwMzA3NjkwMjU0",
      "after": "MTIwMjQxOTIzMDg5OTEwMjU0"
    }
  }
}

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