Thumbnails of an ad video — Facebook API

Video Thumbnails

GET/{version}/{video_id}/thumbnailsVia 360: GET https://partner.quantri360.com/v1/facebook/{version}/{video_id}/thumbnails

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 ảnh thu nhỏ Meta tự sinh cho một video (thường khoảng 15 ảnh) và ảnh đang được chọn làm bìa. Dùng để chọn ảnh bìa (image_url) khi tạo creative video.

Không phân trang — trả hết một lần.
Link uri có hạn: dùng ngay khi tạo creative, không lưu lâu dài.

Request

Endpoint

GET https://partner.quantri360.com/v1/facebook/{version}/{video_id}/thumbnails

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
video_id	path	string	Yes	482757654744969	Id video (từ `GET /act_{account_id}/advideos`).
platform_shop_id	query	string	No	act_5924809560908319	Tài khoản quảng cáo chứa video, dạng `act_<id>`. BẮT BUỘC khi brand nối nhiều tài sản Facebook.

Request examples

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/482757654744969/thumbnails?platform_shop_id=act_5924809560908319" \
  -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/482757654744969/thumbnails",
    params={
        "platform_shop_id": "act_5924809560908319"
    },
    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/482757654744969/thumbnails');
for (const [k, v] of Object.entries({"platform_shop_id":"act_5924809560908319"})) 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/482757654744969/thumbnails' . '?' . http_build_query(['platform_shop_id' => 'act_5924809560908319']);
$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[]		Ảnh thu nhỏ.
id	string	1044366183676120
uri	string		Link ảnh (CDN có hạn).
width / height	int	900 / 900	Kích thước (px).
scale	int	1
is_preferred	bool	true	`true` = ảnh đang làm bìa (chỉ một ảnh).

Response sample

{
  "data": [
    {
      "id": "1044366123676126",
      "height": 900,
      "scale": 1,
      "uri": "https://scontent.fsgn13-2.fna.fbcdn.net/v/t15.5256-10/…",
      "width": 900,
      "is_preferred": false
    },
    {
      "id": "1044366183676120",
      "height": 900,
      "scale": 1,
      "uri": "https://scontent.fsgn13-2.fna.fbcdn.net/v/t15.5256-10/…",
      "width": 900,
      "is_preferred": true
    }
  ]
}

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