API influencer cho dữ liệu gửi quà của bạn.

API dùng để làm gì

API dành cho người vận hành hoặc lập trình viên muốn đưa dữ liệu của Pozto sang nơi khác: một base Airtable, kho dữ liệu, bảng điều khiển hay công cụ nội bộ. Hoặc theo chiều ngược lại: thêm creator từ hệ thống gửi quà của bạn, để không ai phải nhập hai lần.

API làm việc trên danh sách của chính bạn, những creator bạn đã gửi sản phẩm. Đây không phải cơ sở dữ liệu influencer để tìm kiếm. Nếu đó là thứ bạn cần ở một API influencer, Pozto không phải lựa chọn phù hợp.

Khóa, base URL và giới hạn

• Base URL: https://pozto.co/api/v1
• Khóa: chủ sở hữu đội tạo khóa trong Cài đặt → API, với gói Brand. Khóa bắt đầu bằng pz_ và chỉ hiển thị một lần: Pozto chỉ lưu dấu vân tay của khóa, nên hãy sao chép ngay lúc đó. Đặt tên cho mỗi khóa theo mục đích sử dụng, và thu hồi bất cứ lúc nào. Trang Cài đặt cho biết lần cuối mỗi khóa được dùng.
• Cách gửi: Authorization: Bearer pz_… trong mọi request.
• Phạm vi: một khóa đọc và thêm dữ liệu cho mọi thương hiệu trong đội của bạn.
• Giới hạn tần suất: 120 request mỗi phút cho mỗi khóa.
• Phân trang: GET /creators và GET /posts trả về 100 mục mỗi lần, hoặc tối đa 500 với &limit=. Khi còn nữa, phản hồi có next_cursor: gửi lại nó dưới dạng &cursor= để lấy trang tiếp theo. Ở trang cuối, giá trị này là null.
• Định dạng: JSON cho cả đầu vào và đầu ra. Id là chuỗi, và ngày theo chuẩn ISO 8601.

Endpoint

Một creator và một bài đăng gồm những gì

Một creator đi kèm tên, email, tài khoản (và mỗi tên tài khoản có được tìm thấy không), mã giảm giá, trạng thái, và từng món quà: sản phẩm và những thứ còn lại trong hộp, chiến dịch, ngày gửi và ngày nhận, hạn chót tính bằng ngày, mã vận đơn, phí, số bài mong muốn và số bài đã đăng.

Một bài đăng là một video, kèm mọi nền tảng mà nó được đăng lên: link, caption, ngày đăng và có gắn thẻ bạn không. Tiếp theo là món quà và sản phẩm mà bài đăng được tính cho, và cách Pozto đưa ra quyết định đó. Sau đó là kiểm tra video: sản phẩm của bạn có được tìm thấy không, từng khoảnh khắc trên màn hình tính bằng giây, từng lần được nói ra kèm câu nói, và một bản tóm tắt ngắn. Cuối cùng là ghi chú quảng cáo: rõ ràng, mờ nhạt hoặc không có, kèm lý do.

Thêm creator và bài đăng

POST /creators nhận brand_id và handles: @tên, link hồ sơ hoặc link kiểu Linktree, tối đa sáu. Nó cũng nhận platform, name, email, codes, product (id hoặc tên; tên mới sẽ thêm sản phẩm), shipped_at, delivered_at, due_days (21 nếu bạn bỏ trống) và tracking. Creator đã có trong danh sách, được khớp theo bất kỳ tài khoản nào hoặc email, sẽ nhận thêm món quà thay vì bị tạo trùng. Phản hồi là 201 cho creator mới và 200 cho creator đã có, kèm id của creator và id của món quà.

POST /posts nhận brand_id và url, cùng creator_id và product_id tùy chọn. Bài đăng được xếp vào người sở hữu tài khoản, thêm vào danh sách của bạn nếu họ là người mới, và đưa vào hàng chờ kiểm tra video. Phản hồi cho biết bài đăng có mới không, tên tài khoản, nền tảng và có được tính là bài đăng về bạn không.

# Creator đang trễ hạn, trong một thương hiệu
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Thêm một creator và món quà bạn đã gửi
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"}'

# Bài đăng từ ngày 1 tháng 10, mới nhất trước
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Trang tiếp theo: next_cursor từ phản hồi trước
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Lỗi

Lỗi được trả về dưới dạng JSON với một câu đơn giản, như {"error": "…"}, và mã trạng thái 4xx:

• 400: body không phải JSON, hoặc một trường không hợp lệ, như ngày nhận hàng ở tương lai.
• 401: không có khóa, hoặc khóa sai hay đã bị thu hồi.
• 403: đội của bạn không dùng gói Brand.
• 404: không có thương hiệu nào với brand_id đó trong đội của bạn.
• 409: thương hiệu đang bị khóa, vì gói của bạn có ít thương hiệu hơn số thương hiệu đội bạn đang dùng.
• 429: hơn 120 request trong một phút.

Những gì API không làm

• Không tìm kiếm influencer. API đọc và thêm vào danh sách của chính bạn. Tìm creator là tính năng Tìm creator, trong ứng dụng.
• Không có lượt xem, lượt thích hay EMV trong phản hồi. Chúng có trong ứng dụng từ gói Starter, và trong báo cáo hằng tuần. Xem báo cáo influencer.
• Không có webhook. Để lấy bài đăng mới, gọi GET /posts với since.
• Không sửa hay xóa. API chỉ đọc và thêm. Thay đổi và xóa được thực hiện trong ứng dụng.
• Không có khóa cho từng người. Khóa thuộc về đội, và chỉ chủ sở hữu tạo được.

Nội dung bài đăng giống như trong ứng dụng: Pozto tìm bài đăng bằng cách xem video, khung hình, âm thanh và caption, nên bài đăng không gắn thẻ cũng được trả về. Theo dõi influencer giải thích cách bài đăng được tìm thấy.

Bảng giá

API đi kèm gói Brand: $999 mỗi tháng, hoặc $799 mỗi tháng khi trả theo năm, với 10 thương hiệu, 1,000 creator đang hoạt động, không giới hạn người dùng và đăng nhập một lần (SSO). Mọi tính năng khác của Pozto bắt đầu từ các gói thấp hơn, và gói miễn phí bao gồm 10 creator đầu tiên của bạn. Xem các gói.