Page Live Videos
GET/{version}/{page_id}/live_videosVia 360: GET https://partner.quantri360.com/v1/facebook/{version}/{page_id}/live_videos
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
Các phiên live của Trang (đang live, đã kết thúc và lưu thành video, đã lên lịch): trạng thái, thời điểm tạo, video gắn với phiên — lấy video.id để xem insight sau live.
Request
Endpoint
GET https://partner.quantri360.com/v1/facebook/{version}/{page_id}/live_videos
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 | |
| page_id | path | string | Yes | 871110146581478 | Id Trang đã nối. |
| fields | query | string | No | id,title,status,creation_time,permalink_url,video{id} | Trường cần lấy. |
| broadcast_status | query | string | No | ["LIVE","VOD"] | Mảng JSON lọc trạng thái: LIVE · VOD · SCHEDULED_UNPUBLISHED · UNPUBLISHED … |
| limit | query | int | No | 25 | Số phiên mỗi trang. |
| after | query | string | No | paging.cursors.after của trang trước. |
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/871110146581478/live_videos?fields=id%2Ctitle%2Cstatus%2Ccreation_time%2Cpermalink_url%2Cvideo%7Bid%7D&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/871110146581478/live_videos",
params={
"fields": "id,title,status,creation_time,permalink_url,video{id}",
"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/871110146581478/live_videos');
for (const [k, v] of Object.entries({"fields":"id,title,status,creation_time,permalink_url,video{id}","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/871110146581478/live_videos' . '?' . http_build_query(['fields' => 'id,title,status,creation_time,permalink_url,video{id}', '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[] | Phiên live, mới nhất trước; rỗng khi Trang chưa từng live. | |
| id | string | 1148234844626601 | Id phiên live (KHÁC id video). |
| title | string | Tiêu đề (chỉ có khi đặt). | |
| status | string | VOD | `LIVE` = đang phát · `VOD` = đã kết thúc, lưu thành video · `SCHEDULED_UNPUBLISHED` = đã lên lịch … |
| creation_time | string | 2026-10-29T04:05:55+0000 | ISO 8601, UTC (tên trường là `creation_time`, không phải `created_time`). |
| permalink_url | string | /1138881128895306/videos/2188168395246441 | Đường dẫn tương đối. |
| video | object | {"id":"2188168395246441"} | Video lưu của phiên — dùng id này cho `/video_insights`; bài viết của phiên có id `<page_id>_<video id>`. |
| paging | object | `{cursors}` (có thể không có `next` dù còn dữ liệu — dừng khi `data` rỗng). |
Response sample
{
"data": [
{
"id": "1148234844626601",
"status": "VOD",
"creation_time": "2026-10-29T04:05:55+0000",
"permalink_url": "/1138881128895306/videos/2188168395246441",
"video": {
"id": "2188168395246441"
}
},
{
"id": "1141512628632156",
"status": "VOD",
"creation_time": "2026-10-22T04:07:52+0000",
"permalink_url": "/1138881128895306/videos/2001333727229046",
"video": {
"id": "2001333727229046"
}
}
],
"paging": {
"cursors": {
"before": "QVFIVDQtdHd3…",
"after": "QVFIVDZA1ZAF…"
}
}
}
Get started
- Sign up for Partner
- Enable a data type of the Trang & Messenger group on the platform page
- Create an API key (tick the Facebook channel)
- Call it as in the examples above