Back
RESTful APIv1.0
API 文件
透過 Moodboard API，將創作者搜尋、配對與數據分析能力整合至您的系統中。
基礎網址
https://api.moodboard.today/v1
快速開始
透過以下步驟，在數分鐘內開始使用 Moodboard API。
1
申請 API Key
在「設定」頁面產生您的 API 金鑰。企業方案客戶可直接聯絡專屬客戶經理取得。
2
安裝 SDK（選用）
我們提供 Node.js 和 Python 的官方 SDK，簡化整合流程。
3
發送第一個請求
使用您的 API Key 向 /v1/creators/search 端點發送請求，即可獲得推薦結果。
身份驗證
所有請求需在 Header 中附帶 API Key：
// Header
Authorization: Bearer YOUR_API_KEY
API 端點
POST
/v1/creators/search搜尋創作者
根據品牌描述、目標平台與預算，AI 智能推薦最佳創作者。
GET
/v1/creators/{id}取得創作者資料
查詢指定創作者的完整個人檔案，包括受眾分析與互動數據。
POST
/v1/campaigns建立推廣活動
建立新的推廣活動，並自動配對合適的創作者。
GET
/v1/campaigns/{id}/report取得成效報告
取得指定活動的完整成效報告，含觸及率、互動率與 CPE。
POST
/v1/creators/{id}/invite發送邀請
向指定創作者發送合作邀請，支援自訂訊息與合作條件。
GET
/v1/analytics/overview數據總覽
取得帳戶下所有活動的整體數據分析與趨勢。
請求限制
API 請求限制根據方案而異：
| Plan | Rate Limit |
|---|---|
| Pro | 100 次 / 分鐘 |
| Enterprise | 自訂 |
官方 SDK
使用官方 SDK 更快速整合 Moodboard API。
Node.js
$ npm install @moodboard/sdk
Python
$ pip install moodboard-sdk
需要技術支援？
如有任何 API 整合問題，歡迎聯絡我們的技術團隊。