สินค้า
–
รายได้รวม
–
ยอดขายรวม
–
ราคาเฉลี่ย
–
–
Base URL: · ยืนยันตัวตนด้วย header X-API-Key หรือ query ?key=
1) ส่งข้อมูลขึ้นเว็บ — POST /api/push
POST /api/push
X-API-Key: <your key>
Content-Type: application/json
{
"batch": "Kalodata 2026-08-21",
"mode": "append", // append | replace | new
"email": "you@mail.com",
"rows": [
["1","1729...","https://tiktok...","https://img...","data:image/png;base64,...",
"Up 23%","ชื่อสินค้า","฿199","฿1.2M","+23%","6.5K","฿300K","12%","45",
"2026-08-20","3.2%","฿90K"]
]
}
ลำดับ 21 ช่อง: rank, product_id, tiktok_link, img_url, chart_b64, trend, name,
price, revenue, growth, sold, live_rev, commission, creators, date, conversion, card_rev,
rating, avg_price, shipping, video_rev — ส่งแค่ 17 ช่องแรกก็ยังใช้ได้
ส่งเป็น object ก็ได้ เช่น {"product_id":"...","name":"..."} · รองรับ Content-Encoding: gzip
2) ดึงข้อมูลไปใช้ในโปรแกรม — GET /api/products
GET /api/products?key=<key>&batch=0&q=&sort=revenue&order=desc&limit=200&offset=0
&min_revenue=0&min_sold=0&min_growth=0&charts=0
-> {"ok":true,"total":123,"summary":{...},"products":[{...}]}
ตัวอย่างโปรแกรม Python ดึงข้อมูลจากเว็บ
import requests
API = ""
KEY = "<your key>"
r = requests.get(API + "/api/products",
headers={"X-API-Key": KEY},
params={"batch": 0, "sort": "revenue", "limit": 500})
for p in r.json()["products"]:
print(p["rank"], p["name"], p["revenue"], p["sold"], p["tiktok_link"])
Endpoint อื่น
GET /api/batches รายชื่อชุดข้อมูล
GET /api/product/{id} สินค้ารายตัว (มี chart_b64)
GET /api/export.csv ดาวน์โหลด CSV
GET /api/health สถานะระบบ (ไม่ต้องใช้ key)
DELETE /api/batch/{id} ลบชุดข้อมูล
GET /api/keys ดู API key ทั้งหมด
POST /api/keys สร้าง key ใหม่ {"label":"...","can_write":false}