AffiBuild Developer Console
DEVELOPER DOCUMENTATION

Trends API v1

อ่านข้อมูล Shopee Trends เข้าระบบ เว็บไซต์ หรือ AI Agent ของคุณผ่าน REST API แบบ read-only

https://affibuild.com/api/trends/v1
01

เริ่มต้นใน 3 ขั้นตอน

สร้างคีย์จาก Developer Console แล้วทดลองเรียก endpoint ที่ต้องการ

  1. สร้าง API keyเก็บคีย์ไว้ใน Secret หรือ environment variable ของ server
  2. เรียกข้อมูลแบบ GETเริ่มจาก per_page ขนาดเล็ก แล้วตรวจ status code และ requestId
  3. ตรวจ freshness ก่อนแสดงผลแสดงเวลาที่พบข้อมูลให้ผู้ใช้เห็น และจัดการ stale data ตามกติกาของคุณ
02

Endpoints

ทุก endpoint เป็น read-only และใช้คีย์ชุดเดียวกันของบัญชีคุณ

GET /productsรายการสินค้า พร้อม items, pagination และ meta
GET /products/{id}รายละเอียดสินค้าหนึ่งรายการจาก id ภายใน Trends
GET /categoriesรายการหมวดหมู่สำหรับใช้เป็นตัวกรอง
GET /statusสถานะบริการ, meta.freshness และ score_version

ฟิลด์อาจเพิ่มขึ้นได้ ให้ client รองรับ unknown fields และอย่าผูกระบบกับลำดับฟิลด์

03

ตัวกรองสินค้า

ใช้ร่วมกันได้ตามต้องการ ระบบจะตรวจสอบขอบเขตก่อนหักโควตา

pageper_page (1–48)qcategorysort=opportunitymin_pricemax_pricemin_scoremin_ratingmin_salesmall_only
04

ตัวอย่างการเรียกใช้งาน

ตัวอย่างทั้งหมดทำงานจาก server-side เท่านั้น

cURL

curl 'https://affibuild.com/api/trends/v1/products?sort=opportunity&per_page=10' \
  -H "Authorization: Bearer $AFFIBUILD_TRENDS_API_KEY"

JavaScript / TypeScript

const response = await fetch(
  'https://affibuild.com/api/trends/v1/products?per_page=10',
  { headers: { Authorization: 'Bearer ' + process.env.AFFIBUILD_TRENDS_API_KEY } }
);
if (!response.ok) throw new Error(await response.text());
const { items, meta } = await response.json();

Python

import os, requests
response = requests.get(
    'https://affibuild.com/api/trends/v1/products',
    params={'sort': 'opportunity', 'per_page': 10},
    headers={'Authorization': 'Bearer ' + os.environ['AFFIBUILD_TRENDS_API_KEY']},
    timeout=20,
)
response.raise_for_status()
data = response.json()
05

Agent, n8n และ Make

ให้เครื่องมือภายนอกเรียกข้อมูลได้ แต่ให้คีย์อยู่ใน credentials ของระบบเสมอ

AI Agent

กำหนด tool เป็น GET /products พร้อม schema ของ filters ให้ Agent เลือกเอง ตรวจ freshness และไม่อ้างว่าคะแนนคือยอดขายที่รับประกัน ทั้งนี้ product_url เป็น URL ต้นฉบับ ไม่ใช่ Affiliate link หากจะเผยแพร่เป็นลิงก์ Affiliate ให้ Agent สร้างแยกตาม คู่มือ Shopee โดยใช้ ID ที่ผู้ใช้ให้หรือระบบปลายทางที่ได้รับอนุญาตเท่านั้น

n8n / Make

ใช้ HTTP Request → GET → Header Auth; เก็บ Authorization ใน Credentials, ตั้ง per_page ไม่เกิน 48 และหน่วงตาม rate limit

ปลายทางของคุณ

dedupe ด้วย product_key, เก็บ product_url ต้นฉบับไว้แยกจาก Affiliate link และแสดง source กับเวลาข้อมูล

06

โควตาและข้อผิดพลาด

โควตา API เป็นรอบบริการและแชร์กันในทุกคีย์ของบัญชีเดียวกัน

การนับโควตา

คำขอสำเร็จนับ 1 คำขอ และหักแถวตามจำนวนที่ส่งคืนจริง categories/status ไม่หักแถว คำขอที่ล้มเหลวไม่หักโควตา แต่ยังอยู่ภายใต้ burst และ rate limit

ขีดจำกัด

สูงสุด 48 สินค้าต่อคำขอ และพร้อมกัน 2 คำขอ หากได้ 429 ให้ดู Retry-After และอย่า retry ทันทีเมื่อเป็น QUOTA_EXCEEDED

รหัสที่พบบ่อย

401 คีย์ไม่ถูกต้อง · 403 รอบหมดอายุ · 404 ไม่พบ · 429 ถี่หรือโควตาเต็ม · 503 บริการไม่พร้อม พร้อม requestId สำหรับตรวจสอบ

สิทธิหน้าเว็บ Trends แยกจาก REST API: Watchlist Trial 20 · Start 100 · Plus 500 · Pro 2,000 รายการ และโควตาส่งออก CSV/Excel Trial 500 · Start 3,000 · Plus 20,000 · Pro 100,000 แถวต่อรอบ การส่งออกไม่หักจำนวนคำขอหรือแถว API สูงสุด 2,000 แถวต่อไฟล์ / 5 ครั้งต่อนาที หากมี Workspace ด้วย ให้เลือกยอดส่งออกของแพ็กเกจที่จะใช้ ระบบไม่รวมยอดและไม่สลับโควตาอัตโนมัติ

07

ความหมายของข้อมูล

ใช้ข้อมูลอย่างรับผิดชอบและสื่อสารข้อจำกัดให้ผู้ใช้ปลายทางรู้