Influencer API สำหรับข้อมูลการส่งของของคุณ

API นี้มีไว้ทำอะไร

มีไว้สำหรับทีมปฏิบัติการหรือนักพัฒนาที่อยากเอาข้อมูลของ Pozto ไปไว้ที่อื่น: ฐานข้อมูล Airtable คลังข้อมูล แดชบอร์ด หรือเครื่องมือภายใน หรือกลับกัน: เพิ่มครีเอเตอร์จากระบบที่ใช้ส่งของ จะได้ไม่มีใครต้องพิมพ์ซ้ำสองรอบ

API ทำงานกับรายชื่อของคุณเอง คือครีเอเตอร์ที่คุณส่งสินค้าให้ ไม่ใช่ฐานข้อมูลอินฟลูเอนเซอร์ไว้ค้นหา ถ้านั่นคือสิ่งที่คุณต้องการจาก influencer API Pozto ไม่ใช่คำตอบ

คีย์ base URL และขีดจำกัด

• Base URL: https://pozto.co/api/v1
• คีย์: เจ้าของทีมสร้างได้ใน ตั้งค่า → API ในแพ็กเกจ Brand คีย์ขึ้นต้นด้วย pz_ และแสดงเพียงครั้งเดียว: Pozto เก็บไว้แค่ลายนิ้วมือของคีย์ จึงต้องคัดลอกตอนนั้น ตั้งชื่อแต่ละคีย์ตามการใช้งาน และเพิกถอนได้ทุกเมื่อ หน้าตั้งค่าแสดงว่าแต่ละคีย์ถูกใช้ล่าสุดเมื่อไร
• การส่งคีย์: Authorization: Bearer pz_… ในทุกคำขอ
• ขอบเขต: คีย์เดียวอ่านและเพิ่มข้อมูลได้ในทุกแบรนด์ของทีมคุณ
• ขีดจำกัดคำขอ: 120 คำขอต่อนาทีต่อคีย์
• หน้า: GET /creators และ GET /posts ส่งกลับครั้งละ 100 รายการ หรือสูงสุด 500 ด้วย &limit= เมื่อมีเพิ่มเติม คำตอบจะมี next_cursor ให้ส่งกลับเป็น &cursor= เพื่อรับหน้าถัดไป ในหน้าสุดท้ายจะเป็น null
• รูปแบบ: JSON ทั้งขาเข้าและขาออก id เป็นสตริง และวันที่เป็น ISO 8601

Endpoint

ข้อมูลครีเอเตอร์และโพสต์มีอะไรบ้าง

ครีเอเตอร์มาพร้อมชื่อ อีเมล บัญชี (และแต่ละแฮนเดิลถูกพบหรือไม่) โค้ดส่วนลด สถานะ และการส่งของแต่ละครั้ง: สินค้าและของอื่นในกล่อง แคมเปญ วันที่ส่งและวันที่ของถึง กำหนดเป็นจำนวนวัน เลขพัสดุ ค่าจ้าง จำนวนโพสต์ที่ต้องการ และจำนวนโพสต์จนถึงตอนนี้

โพสต์คือวิดีโอหนึ่งคลิป พร้อมทุกแพลตฟอร์มที่ลงไว้: ลิงก์ แคปชัน วันที่โพสต์ และแท็กคุณหรือไม่ ตามด้วยการส่งของและสินค้าที่โพสต์นั้นนับให้ และ Pozto ตัดสินอย่างไร จากนั้นคือ ผลตรวจวิดีโอ: พบสินค้าของคุณไหม แต่ละช่วงที่อยู่บนจอเป็นวินาที แต่ละครั้งที่ถูกพูดถึงพร้อมคำพูด และสรุปสั้นๆ และ การเปิดเผยโฆษณา: clear, weak หรือ none พร้อมเหตุผล

การเพิ่มครีเอเตอร์และโพสต์

POST /creators รับ brand_id และ handles: @ชื่อ ลิงก์โปรไฟล์ หรือลิงก์แบบ Linktree สูงสุดหกรายการ และยังรับ platform, name, email, codes, product (id หรือชื่อ ชื่อใหม่จะเพิ่มสินค้าใหม่), shipped_at, delivered_at, due_days (21 ถ้าไม่ระบุ) และ tracking ครีเอเตอร์ที่อยู่ในรายชื่อแล้ว ซึ่งจับคู่ด้วยบัญชีใดบัญชีหนึ่งหรืออีเมล จะได้รับการส่งของเพิ่มแทนการสร้างซ้ำ ตอบกลับ 201 สำหรับครีเอเตอร์ใหม่และ 200 สำหรับคนที่มีอยู่แล้ว พร้อม id ของครีเอเตอร์และ id ของการส่งของ

POST /posts รับ brand_id และ url และระบุ creator_id และ product_id ได้ถ้าต้องการ โพสต์จะถูกจัดไว้ใต้เจ้าของบัญชี เพิ่มเข้ารายชื่อถ้าเป็นคนใหม่ และเข้าคิวรอตรวจวิดีโอ ตอบกลับว่าเป็นโพสต์ใหม่หรือไม่ แฮนเดิล แพลตฟอร์ม และนับเป็นโพสต์เกี่ยวกับคุณหรือไม่

# ครีเอเตอร์ที่เลยกำหนด ในแบรนด์เดียว
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# เพิ่มครีเอเตอร์และของที่คุณส่งให้
curl -X POST https://pozto.co/api/v1/creators \
  -H "Authorization: Bearer pz_…" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"BRAND_ID","handles":["@maya.glows"],"product":"Glow Serum","shipped_at":"2026-10-14"}'

# โพสต์ตั้งแต่ 1 ตุลาคม ใหม่สุดก่อน
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# หน้าถัดไป: next_cursor จากคำตอบก่อนหน้า
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

ข้อผิดพลาด

ข้อผิดพลาดจะส่งกลับเป็น JSON ที่มีประโยคธรรมดาหนึ่งประโยค เช่น {"error": "…"} พร้อมสถานะ 4xx:

• 400: เนื้อหาคำขอไม่ใช่ JSON หรือมีฟิลด์ที่ไม่ถูกต้อง เช่น วันที่ของถึงที่อยู่ในอนาคต
• 401: ไม่มีคีย์ หรือคีย์ผิดหรือถูกเพิกถอนแล้ว
• 403: ทีมของคุณไม่ได้ใช้แพ็กเกจ Brand
• 404: ไม่มีแบรนด์ที่มี brand_id นั้นในทีมของคุณ
• 409: แบรนด์ถูกล็อก เพราะแพ็กเกจของคุณมีจำนวนแบรนด์น้อยกว่าที่ทีมใช้อยู่
• 429: เกิน 120 คำขอในหนึ่งนาที

สิ่งที่ API ไม่ได้ทำ

• ไม่มีการค้นหาอินฟลูเอนเซอร์ API อ่านและเพิ่มข้อมูลในรายชื่อของคุณเอง การค้นหาครีเอเตอร์อยู่ที่ ค้นหาครีเอเตอร์ ในแอป
• ไม่มียอดวิว ไลก์ หรือ EMV ในผลลัพธ์ ข้อมูลเหล่านี้อยู่ในแอปตั้งแต่แพ็กเกจ Starter และในรายงานรายสัปดาห์ ดูรายงานอินฟลูเอนเซอร์
• ไม่มี webhook ถ้าต้องการโพสต์ใหม่ ให้เรียก GET /posts พร้อม since
• ไม่มีการแก้ไขหรือลบ API อ่านและเพิ่มเท่านั้น การแก้ไขและการลบทำในแอป
• ไม่มีคีย์รายบุคคล คีย์เป็นของทีม และมีแต่เจ้าของที่สร้างได้

ข้อมูลในโพสต์เหมือนกับในแอป: Pozto หาโพสต์ด้วยการดูวิดีโอ ทั้งเฟรม เสียง และแคปชัน โพสต์ที่ไม่ได้แท็ก จึงเข้ามาด้วย การติดตามอินฟลูเอนเซอร์ อธิบายว่าโพสต์ถูกค้นพบได้อย่างไร

ราคา

API มาพร้อมแพ็กเกจ Brand: $999 ต่อเดือน หรือ $799 ต่อเดือนเมื่อจ่ายรายปี พร้อม 10 แบรนด์ ครีเอเตอร์ที่ใช้งาน 1,000 คน ผู้ใช้ไม่จำกัด และ single sign-on ฟีเจอร์อื่นทั้งหมดของ Pozto เริ่มที่แพ็กเกจที่ต่ำกว่า และแพ็กเกจฟรีครอบคลุมครีเอเตอร์ 10 คนแรกของคุณ ดูแพ็กเกจ