Bài người khác gắn thẻ tài khoản — API Facebook

IG User Tags

GET/{version}/{ig_user_id}/tagsGọi qua 360: GET https://partner.quantri360.com/v1/facebook/{version}/{ig_user_id}/tags

Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.

Mô tả API

Bài gắn thẻ tài khoản

Tài khoản Instagram phải gắn với Trang đã kết nối trong không gian. Media và bình luận được kiểm chủ sở hữu trước khi đọc.
Phân trang: gửi lại cursors.after qua tham số after; không dùng URL phân trang có token.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/facebook/{version}/{ig_user_id}/tags

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
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.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
version	path	string	Không	v25.0	Phiên bản API.
ig_user_id	path	string	Không	178410000000001	Mã tài sản Instagram thuộc Trang đã nối.
platform_shop_id	query	string	Không	100000000001	Mã Trang đã nối có gắn tài khoản Instagram; bắt buộc khi có nhiều Trang.
fields	query	string	Không	id,caption,media_type,permalink	Trường / chỉ số cần lấy hoặc từ khóa cần tìm.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/178410000000001/tags?platform_shop_id=100000000001&fields=id%2Ccaption%2Cmedia_type%2Cpermalink" \
  -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/178410000000001/tags",
    params={
        "platform_shop_id": "100000000001",
        "fields": "id,caption,media_type,permalink"
    },
    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/178410000000001/tags');
for (const [k, v] of Object.entries({"platform_shop_id":"100000000001","fields":"id,caption,media_type,permalink"})) 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/178410000000001/tags' . '?' . http_build_query(['platform_shop_id' => '100000000001', 'fields' => 'id,caption,media_type,permalink']);
$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;