Human-readable targeting description — Facebook API

Targeting Sentence Lines

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

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

Diễn giải một targeting_spec thành các dòng chữ dễ đọc (vị trí, độ tuổi, giới tính, vị trí quảng cáo…) theo ngôn ngữ người ủy quyền. Dùng để hiển thị tóm tắt nhắm mục tiêu cho người duyệt / khách.

Đường dẫn có act_<id> → 360 tự chọn token tài khoản.
Không gửi vị trí quảng cáo thì kết quả có thêm dòng "Vị trí quảng cáo" mặc định (bảng feed, cột phải, Audience Network).
Chỉ để hiển thị — câu chữ có thể đổi, không phân tích tự động.

Request

Endpoint

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

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_).
targeting_spec	query	string	Yes	{"geo_locations":{"countries":["VN"]},"age_min":25,"age_max":45,"genders":[2]}	JSON nhắm mục tiêu (cùng cấu trúc `targeting` của nhóm quảng cáo).

Request examples

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/act_5924809560908319/targetingsentencelines?targeting_spec=%7B%22geo_locations%22%3A%7B%22countries%22%3A%5B%22VN%22%5D%7D%2C%22age_min%22%3A25%2C%22age_max%22%3A45%2C%22genders%22%3A%5B2%5D%7D" \
  -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/targetingsentencelines",
    params={
        "targeting_spec": "{\"geo_locations\":{\"countries\":[\"VN\"]},\"age_min\":25,\"age_max\":45,\"genders\":[2]}"
    },
    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/targetingsentencelines');
for (const [k, v] of Object.entries({"targeting_spec":"{\"geo_locations\":{\"countries\":[\"VN\"]},\"age_min\":25,\"age_max\":45,\"genders\":[2]}"})) 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/targetingsentencelines' . '?' . http_build_query(['targeting_spec' => '{"geo_locations":{"countries":["VN"]},"age_min":25,"age_max":45,"genders":[2]}']);
$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
targetingsentencelines	object[]		Các dòng diễn giải.
content	string	Độ tuổi:	Nhãn dòng.
children	string[]	["25 - 45"]	Giá trị.
params	object		Có thể kèm lại targeting đã chuẩn hóa.

Response sample

{
  "targetingsentencelines": [
    {
      "content": "Vị trí - Sống tại:",
      "children": [
        "Việt Nam"
      ]
    },
    {
      "content": "Độ tuổi:",
      "children": [
        "25 - 45"
      ]
    },
    {
      "content": "Giới tính:",
      "children": [
        "Nữ"
      ]
    },
    {
      "content": "Vị trí quảng cáo:",
      "children": [
        "trên trang: Cột bên phải trên máy tính để bàn, Bảng feed trên máy tính, Bảng feed trên thiết bị di động hoặc Trang web và ứng dụng của bên thứ ba trên thiết bị di động (Audience Network)"
      ]
    }
  ]
}

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