Shares of a post — Facebook API

Shared Posts

GET/{version}/{post_id}/sharedpostsVia 360: GET https://partner.quantri360.com/v1/facebook/{version}/{post_id}/sharedposts

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

Lượt chia sẻ công khai của một bài viết trên Trang (bài chia sẻ người khác đăng lại).

Chỉ trả lượt chia sẻ mà Facebook cho phép Trang xem — chia sẻ ở chế độ riêng tư (bạn bè, chỉ mình tôi) không có trong danh sách, nên thường ít hơn số đếm shares của bài. Bài chưa có lượt chia sẻ công khai → {"data": []}.

Request

Endpoint

GET https://partner.quantri360.com/v1/facebook/{version}/{post_id}/sharedposts

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
post_id	path	string	Yes	559411604582644_1234567890	Id bài viết dạng <page_id>_<post_id>.
fields	query	string	No	id,created_time,from,message	Trường của bài chia sẻ.
limit	query	int	No	25
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/559411604582644_1234567890/sharedposts?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/559411604582644_1234567890/sharedposts",
    params={
        "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/559411604582644_1234567890/sharedposts');
for (const [k, v] of Object.entries({"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/559411604582644_1234567890/sharedposts' . '?' . http_build_query(['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	Description
data	object[]	Bài chia sẻ.
id	string	Id bài chia sẻ.
created_time	string	ISO 8601, UTC.
from	object	`{name, id}` người / Trang chia sẻ.
message	string	Lời bình kèm khi chia sẻ.
paging	object	Chỉ có khi còn trang.

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