กำหนด tool เป็น GET /products พร้อม schema ของ filters ให้ Agent เลือกเอง ตรวจ freshness และไม่อ้างว่าคะแนนคือยอดขายที่รับประกัน ทั้งนี้ product_url เป็น URL ต้นฉบับ ไม่ใช่ Affiliate link หากจะเผยแพร่เป็นลิงก์ Affiliate ให้ Agent สร้างแยกตาม คู่มือ Shopee โดยใช้ ID ที่ผู้ใช้ให้หรือระบบปลายทางที่ได้รับอนุญาตเท่านั้น
Trends API v1
อ่านข้อมูล Shopee Trends เข้าระบบ เว็บไซต์ หรือ AI Agent ของคุณผ่าน REST API แบบ read-only
https://affibuild.com/api/trends/v1เริ่มต้นใน 3 ขั้นตอน
สร้างคีย์จาก Developer Console แล้วทดลองเรียก endpoint ที่ต้องการ
- สร้าง API keyเก็บคีย์ไว้ใน Secret หรือ environment variable ของ server
- เรียกข้อมูลแบบ GETเริ่มจาก per_page ขนาดเล็ก แล้วตรวจ status code และ requestId
- ตรวจ freshness ก่อนแสดงผลแสดงเวลาที่พบข้อมูลให้ผู้ใช้เห็น และจัดการ stale data ตามกติกาของคุณ
Endpoints
ทุก endpoint เป็น read-only และใช้คีย์ชุดเดียวกันของบัญชีคุณ
GET /productsรายการสินค้า พร้อม items, pagination และ metaGET /products/{id}รายละเอียดสินค้าหนึ่งรายการจาก id ภายใน TrendsGET /categoriesรายการหมวดหมู่สำหรับใช้เป็นตัวกรองGET /statusสถานะบริการ, meta.freshness และ score_versionฟิลด์อาจเพิ่มขึ้นได้ ให้ client รองรับ unknown fields และอย่าผูกระบบกับลำดับฟิลด์
ตัวกรองสินค้า
ใช้ร่วมกันได้ตามต้องการ ระบบจะตรวจสอบขอบเขตก่อนหักโควตา
pageper_page (1–48)qcategorysort=opportunitymin_pricemax_pricemin_scoremin_ratingmin_salesmall_onlyตัวอย่างการเรียกใช้งาน
ตัวอย่างทั้งหมดทำงานจาก 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()Agent, n8n และ Make
ให้เครื่องมือภายนอกเรียกข้อมูลได้ แต่ให้คีย์อยู่ใน credentials ของระบบเสมอ
ใช้ HTTP Request → GET → Header Auth; เก็บ Authorization ใน Credentials, ตั้ง per_page ไม่เกิน 48 และหน่วงตาม rate limit
dedupe ด้วย product_key, เก็บ product_url ต้นฉบับไว้แยกจาก Affiliate link และแสดง source กับเวลาข้อมูล
โควตาและข้อผิดพลาด
โควตา 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 ด้วย ให้เลือกยอดส่งออกของแพ็กเกจที่จะใช้ ระบบไม่รวมยอดและไม่สลับโควตาอัตโนมัติ
ความหมายของข้อมูล
ใช้ข้อมูลอย่างรับผิดชอบและสื่อสารข้อจำกัดให้ผู้ใช้ปลายทางรู้
product_keyเป็น string รูปแบบ shopid:itemid เพื่อไม่เสียความแม่นยำhistorical_salesคือยอดสะสม ไม่ใช่ยอดต่อเดือน;monthly_salesอาจเป็น null- รูปภาพเป็นข้อมูลต้นทาง และ
product_urlเป็น URL สินค้าต้นฉบับจาก Shopee ไม่ใช่ Affiliate link; REST API/MCP ไม่ใส่ Affiliate ID หรือ Sub ID ให้ - หากต้องการลิงก์ Affiliate ให้สร้าง URL แยกโดยใช้ ID ของผู้ใช้ตามคู่มือ Shopee และเก็บ
product_urlเดิมไว้ - คะแนนเป็นสัญญาณจัดอันดับภายใน ไม่ใช่คำรับประกันยอดขายหรือค่าคอมมิชชั่น
meta.freshness.is_staleใช้แจ้งว่าข้อมูลเกินเกณฑ์ความสดใหม่หรือไม่ ไม่ใช่เวลาจริงแบบ live feed