Get ads by ad_id — API Pancake Chat

get /pages/{page_id}/ads

GET/public_api/v1/pages/{page_id}/adsGọi qua 360: GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/ads

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

Tra TÊN + chiến dịch + tài khoản quảng cáo của tối đa 20 mã quảng cáo (ad id) mà Pancake đã ghi nhận qua hội thoại. Dùng để đổi ad_ids / ad_clicks ở hội thoại, export_data ra tên quảng cáo và chiến dịch khi báo cáo hội thoại theo quảng cáo.

Chỉ tra được mã mà Pancake đã thấy qua hoạt động của khách (ad_ids / ads ở /conversations, ad_clicks ở export_data, ad_id ở thống kê quảng cáo). Mã chưa có khách bấm hoặc không đọc được → phần tử CHỈ có id (thử thật: một quảng cáo năm 2023 và mã không tồn tại đều trả { "id": "…" }).
Lỗi tham số trả HTTP 400 (khác các API khác của Pancake trả 200): thiếu → {"message":"ad_ids is required","success":false}; > 20 mã → {"message":"maximum 20 ad_ids per request","success":false}.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/ads

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	107896751234567	page_id đã nối — có thể bỏ (lấy từ đường dẫn).

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
page_id	path	string	Có	107896751234567	Mã trang đã nối với 360.
ad_ids	query	string	Có	120235393692980041,120239410378260041	Mã quảng cáo cách nhau dấu phẩy, TỐI ĐA 20 mã khác nhau / lần (trùng được gộp, giữ thứ tự).
type	query	string	Không	ads	`ads` (mặc định, Facebook) · `tt_ads` (TikTok).

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/ads?ad_ids=120235393692980041%2C120239410378260041" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/ads",
    params={
        "ad_ids": "120235393692980041,120239410378260041"
    },
    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/pancake_chat/public_api/v1/pages/107896751234567/ads');
for (const [k, v] of Object.entries({"ad_ids":"120235393692980041,120239410378260041"})) 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/pancake_chat/public_api/v1/pages/107896751234567/ads' . '?' . http_build_query(['ad_ids' => '120235393692980041,120239410378260041']);
$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

Tham số phản hồi (nguyên của Pancake Chat)

Tên	Kiểu	Mẫu	Mô tả
success	bool	true
data	object[]		Một phần tử cho mỗi mã gửi lên, đúng thứ tự.
id	string	120235393692980041	Mã quảng cáo (luôn có).
name	string	Quảng cáo Lượt tương tác mới	Tên quảng cáo.
image_url	string	…	Ảnh của mẫu quảng cáo (lưu trên máy chủ Pancake).
campaign_id	string	120239410378530041	Mã chiến dịch.
campaign_name	string	onl - target - 02/02	Tên chiến dịch.
account_id	string	1000033501429628	Tài khoản quảng cáo (không có tiền tố `act_`).

Mẫu phản hồi

{
  "data": [
    {
      "id": "120235393692980041",
      "name": "1",
      "image_url": "…",
      "campaign_id": "120234901087540041",
      "campaign_name": "onl - target - 04/11",
      "account_id": "1000033501429628"
    },
    {
      "id": "23853767528900251"
    },
    {
      "id": "120239410378260041",
      "name": "Quảng cáo Lượt tương tác mới",
      "image_url": "…",
      "campaign_id": "120239410378530041",
      "campaign_name": "onl - target - 02/02",
      "account_id": "1000033501429628"
    }
  ],
  "success": true
}

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Thống kê ở trang nền tảng
Tạo API key (tick kênh Pancake Chat)
Gọi theo ví dụ ở trên