REST API v1 · Stable

SigoMark Public API

Tích hợp toàn bộ pipeline AI của SigoMark vào hệ thống, CMS hoặc workflow tự động của bạn. Quản lý keyword, guide, bài viết, backlink và nhiều hơn nữa qua REST API.

Bắt đầu trong 30 giây

bash
# Lấy thông tin tài khoản
curl https://dashboard.sigomark.com/api/v1/me \
  -H "Authorization: Bearer sk_your_key_here"

# Danh sách project
curl https://dashboard.sigomark.com/api/v1/projects \
  -H "Authorization: Bearer sk_your_key_here"

# Bắt đầu keyword research
curl -X POST https://dashboard.sigomark.com/api/v1/projects/{projectId}/keywords/research \
  -H "Authorization: Bearer sk_your_key_here" \
  -H "Content-Type: application/json"

Toàn bộ API theo nhóm

Tất cả endpoint đều trả về JSON chuẩn, hỗ trợ phân trang.

👤

Me & Usage

GET

Thông tin tài khoản, quota, gói đang dùng

📁

Projects

CRUD

CRUD project, cấu hình domain và brand voice

🔍

Keywords

CRUD

Duyệt keyword, trigger research mới

📋

Guides

CRUD

Duyệt dàn ý, trigger sinh guide từ keyword

📝

Articles

CRUD

Approve, publish, lên lịch bài viết

⚙️

Jobs

GET

Theo dõi trạng thái tác vụ AI đang chạy

🔗

Backlinks

CRUD

Thêm và kiểm tra backlink

📊

SEO Intelligence

GET

Overview, rankings, LinkMap, roadmap

🪝

Webhooks

CRUD

Nhận event real-time khi pipeline hoàn thành

Xác thực & Rate limit

1
Bearer token

Thêm header Authorization: Bearer sk_... vào mọi request.

2
Rate limit theo gói

Pro: 120 request/phút · Agency: 600 request/phút. Vượt giới hạn trả về 429 kèm Retry-After.

3
Gói yêu cầu

API chỉ khả dụng với gói Pro và Agency. Gọi từ gói khác trả về 403.

JSON Response format

{
  "ok": true,
  "data": { ... },
  "paging": {
    "page": 1,
    "pageSize": 20,
    "total": 142
  }
}

// Lỗi
{
  "ok": false,
  "error": "Not found",
  "code": 404
}

Webhooks — event-driven

Đăng ký URL để nhận thông báo khi pipeline AI hoàn thành, không cần polling.

keyword.researched guide.generated article.generated article.published social.posted video.ready backlink.lost job.completed job.failed

Payload ký bằng HMAC-SHA256 với secret bạn tạo khi đăng ký webhook.

Sẵn sàng tích hợp?

Tạo API key trong vài giây. Tài liệu tương tác đầy đủ với Try-it ngay trong browser.