AFFIBUILD TRENDS API & MCP

มีระบบอยู่แล้ว?
ต่อข้อมูล Trends เข้าระบบคุณ

ดึงข้อมูล Shopee Product Feed ที่ผ่านการจัดอันดับยอดขาย อัตราเร่งอันดับ (Trend Score) และคะแนนโอกาสทำเงิน (Opportunity Score) ไปใช้ในเว็บไซต์ แอป ระบบอัตโนมัติ n8n หรือ AI Agent ของคุณได้ทันที

ใช้บัญชี AffiBuild เดิมได้ · ไม่มีการตัดบัตรต่ออายุอัตโนมัติ · API อ่านข้อมูลอย่างเดียว ควรเก็บคีย์ไว้ฝั่งเซิร์ฟเวอร์

ตัวอย่างการเรียกข้อมูล
อ่านข้อมูลเท่านั้น
curl -s "https://affibuild.com/api/trends/v1/products?sort=opportunity&min_score=85&per_page=10" \
  -H "Authorization: Bearer $AFFIBUILD_TRENDS_API_KEY" \
  -H "Accept: application/json"
เก็บคีย์ใน Secret ฝั่งเซิร์ฟเวอร์ดึงสินค้า ร้านค้า และหมวดหมู่พร้อมต่อ n8n และ AI Agent

รายการ Endpoints ที่เปิดให้ใช้งาน

Base URL: https://affibuild.com

GET/api/trends/v1/products

ค้นหา กรอง และจัดอันดับสินค้าขายดีพร้อมแบ่งหน้า (Pagination) และข้อมูลเวลาอัปเดต

GET/api/trends/v1/products/{id}

ดึงรายละเอียดสินค้าเชิงลึก คะแนนย่อยรายด้าน รูปภาพ และประวัติอันดับ/ยอดขายย้อนหลัง 30 รอบ

GET/api/trends/v1/categories

ดึงรายชื่อหมวดหมู่สินค้าทั้งหมด (`slug`, `name`, `product_count`) สำหรับนำไปใช้เป็นตัวกรอง

GET/api/trends/v1/shops

ดึงรายชื่อร้านค้าเด่น (`shopid`, `shop_name`, `product_count`, `sales_count`, `confidence_score`)

GET/api/trends/v1/status

ตรวจสอบเวลาอัปเดตข้อมูลล่าสุด (`freshness`) และเวอร์ชันการคำนวณคะแนนโดยไม่เปลืองโควตาแถวสินค้า

พารามิเตอร์สำหรับกรองสินค้า (/v1/products)

พารามิเตอร์ตัวอย่างคำอธิบาย
qq=ceraveค้นหาด้วยชื่อสินค้า ชื่อร้านค้า หรือแบรนด์
categorycategory=beautyกรองตามรหัสหมวดหมู่ (slug) จาก /categories
shopidshopid=180143985กรองเฉพาะสินค้าในร้านค้าที่ต้องการ
sortsort=trendopportunity (ค่าเริ่มต้น) | trend (อันดับพุ่งแรง) | sales | rank | rating | rating_count | price_asc | newest
min_scoremin_score=85คะแนนโอกาสขั้นต่ำ (0–100 เช่น 85 เพื่อคัดเฉพาะตัวท็อป)
min_price / max_pricemin_price=200&max_price=1500กรองช่วงราคาสินค้า (บาท)
min_salesmin_sales=1000ยอดขายสะสมขั้นต่ำ (ชิ้น)
min_ratingmin_rating=4.8คะแนนรีวิวสินค้าขั้นต่ำ (0–5 ดาว)
mallmall=trueคัดเฉพาะสินค้าจากร้านทางการ (Shopee Mall)
page / per_pagepage=1&per_page=24หน้าที่ต้องการ และจำนวนต่อหน้า (สูงสุด 48 รายการต่อหน้า)

ตัวอย่างข้อมูล JSON ที่ได้รับ

ทุกคำขอจะส่งคืนทั้งคะแนนโอกาส (`opportunity_score`), อัตราเร่งอันดับ (`trend_score`) และสถานะความสดของข้อมูล (`meta.freshness`)

{
  "items": [
    {
      "id": 1024,
      "product_key": "180143985:9007199254",
      "shopid": "180143985",
      "itemid": "9007199254",
      "name": "CeraVe Moisturising Lotion 473ml",
      "shop_name": "cerave_official_shop",
      "category_slug": "beauty",
      "category_name": "สุขภาพและความงาม",
      "price": 708,
      "original_price": 730,
      "discount_pct": 3,
      "rating": 4.9,
      "rating_count": 12450,
      "liked_count": 8320,
      "historical_sales": 41890,
      "is_official_shop": true,
      "current_source_rank": 12,
      "previous_source_rank": 31,
      "opportunity_score": 88.7,
      "trend_score": 92.4,
      "sales_score": 90.1,
      "product_url": "https://shopee.co.th/product/180143985/9007199254",
      "curation_state": "selected",
      "availability": "in_stock"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total": 53235,
    "pages": 5324
  },
  "meta": {
    "freshness": {
      "latest_at": "2026-10-25T00:04:00Z",
      "age_hours": 4.2,
      "stale_after_hours": 192,
      "is_stale": false,
      "source": "Shopee catalog import"
    },
    "score_version": "2.0-feed-only",
    "sales_basis": "historical_sales",
    "commission": "Check in your own Shopee Affiliate account"
  }
}
ต่อยอดได้ตามงาน

เอาข้อมูลที่คัดแล้วไปทำงานต่อ

ใช้เฉพาะ API ก็ได้ หรือใช้หน้าเว็บ Trends สำหรับค้นหาและจัด Watchlist ควบคู่กัน

เว็บและแดชบอร์ดของคุณเอง

นำข้อมูลสินค้า ราคา คะแนนโอกาส และสัญญาณยอดขายไปแสดงผลในเว็บไซต์หรือระบบหลังบ้านของคุณเอง

n8n และระบบอัตโนมัติ

ตั้งเวลาดึงสินค้าดาวรุ่งตามรอบ กรองเฉพาะคะแนนโอกาสสูง แล้วส่งแจ้งเตือนเข้า Line, Discord, Telegram หรือ Google Sheets

AI Agent & MCP

ให้ AI Agent ค้นหาและสรุปสินค้าขายดีตามโจทย์เพื่อช่วยคิดคอนเทนต์หรือคัดสินค้าเข้าแคมเปญอัตโนมัติ

AI AGENT · REMOTE MCP + OAUTH

เชื่อม AI Agent โดยไม่ต้องวาง API Key

แอปที่รองรับ Remote MCP + OAuth สามารถเชื่อมต่อด้วยบัญชี AffiBuild และขอสิทธิ์อ่านข้อมูลสินค้า หมวดหมู่ และเวลาอัปเดต โดยใช้โควตาเดียวกับ REST API ควรอนุญาตเฉพาะแอปที่คุณเชื่อถือ

ขั้นตอนการเชื่อมต่อ

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

01 · สร้าง API Key

สร้างคีย์จากหน้า Developer Console แล้วเก็บไว้ใน Environment Variable ฝั่งเซิร์ฟเวอร์

02 · เรียกข้อมูลด้วยตัวกรอง

เรียก GET /api/trends/v1/products พร้อมตั้งค่า sort=opportunity หรือ sort=trend ตามโจทย์

03 · ตรวจเวลาอัปเดตข้อมูล

ตรวจ meta.freshness จากผลลัพธ์ และแปลง product_url เป็นลิงก์ Affiliate ของคุณก่อนนำไปโปรโมต