Ayrshare API 概觀 - Ayrshare API Documentation

Social Media REST API 讓開發者能透過單一整合介面以程式化方式存取多個社群網路。透過 Ayrshare 的 social API，你可以管理各項社群媒體活動，包含建立與刪除貼文、取得分析資料、處理留言與評論、管理私訊（DM）、建立 Facebook 廣告，以及跨平台執行其他社群媒體操作。此 API 目前支援 13 個主要社群網路：Bluesky、Facebook、Google Business Profile、Instagram、LinkedIn、Pinterest、Reddit、Snapchat、Telegram、Threads、TikTok、X（前身為 Twitter）與 YouTube。透過整合此 API，開發者可以同時自動化在所有這些平台上的社群媒體管理工作。 API 呼叫的請求與回應資料皆為 JSON 格式，方便在大多數程式語言中進行解析與處理。如果你使用 Launch、Business 或 Enterprise Plan，請參閱 Business Plan 概觀、Launch Plan 概觀與 /profiles API 端點。

主要功能

支援 13 個社群網路。
透過你專屬的 API Key 進行安全的 API 存取。
可排程發布到已連結的社群媒體平台。
依據預定的排程自動發布。
支援圖片與影片內容，包含 Reels、Stories 與 Spotlight。
刪除已連結社群網路上的貼文。
完整的貼文互動分析（按讚、分享等）。
社群帳號指標，包含追蹤者數量與人口統計資料。
留言管理：檢視、新增與刪除貼文留言。
可對貼文中所有或特定 URL 進行選擇性縮短網址。
Unsplash 整合：加入指定圖片或依關鍵字隨機選取。
使用相關關鍵字自動產生 hashtag 的選項。
貼文歷史紀錄追蹤，包含非透過 Ayrshare 發布的貼文。
評論管理：取得、回覆與刪除評論回應。
RSS 動態整合，可自動化發布內容。
媒體庫：上傳並儲存要用於貼文的照片與影片。
Social Post Verification System 讓你的社群帳號更安全。

Business Plan 與 Launch Plan

Business Plan 與 Launch Plan 為管理多位使用者與客戶提供的功能：

讓使用者可將自己的社群媒體帳號連結到你的平台。
透過 OAuth 的安全單一登入，快速完成帳號連結。
透過 API 以程式方式建立與移除 User Profile。
存取進階使用者分析。
支援即時更新的 webhook。
在所支援的平台上進行私訊管理。
從既有貼文建立 Facebook 廣告。

如需進一步了解 Business Plan，歡迎與我們聯絡。

Ads API

Ads API 讓你可以從既有貼文建立 Facebook 廣告。

加強貼文推廣觸及更多人。
管理廣告並追蹤成效。
分析廣告花費並優化投放策略。

Ads API

探索 Ads API

Messages API

統一的 Messaging API，讓你可以在主要社群媒體管道（Facebook、Instagram 與 X）上與使用者進行對話。

傳送文字、圖片與影片訊息。
取得完整的對話歷史紀錄。
設定自動化訊息回覆。
透過 webhook 即時接收訊息接收、訊息表情回應以及已讀回條的更新。

此 API 將多個社群媒體管道的訊息操作集中管理，簡化與使用者互動的流程。了解更多…

Messages API

探索統一的 messaging API

Max Pack

透過 Max Pack 加購方案取得更多功能：

Max Pack

透過我們的 Max Pack 加購方案，解鎖 AI 內容生成、強化分析與更廣泛的平台支援等進階功能。

如果你使用 Node.js 開發，可以觀看這支影片，了解如何連結並將貼文發布到 X 與 Facebook。

如果你使用 Node.js，可以參考 social API 示範程式碼，快速開始你自己的 social API 整合。

Social API 示範

探索我們的 Node.js 示範程式碼，快速啟動你的 social API 整合

Base URL

Ayrshare API 所有端點的 base URL 相同： https://api.ayrshare.com/api

授權

Ayrshare 透過 HTTP header 中傳遞的 Authorization token 驗證 API 請求。請務必在 API Key 前加上 Bearer。你可以在 Ayrshare Dashboard 中切換到 Primary Profile 找到 API Key。如果你是 Business 或 Enterprise 使用者，可以建立帶有 Profile Key 的 User Profile 來管理多位客戶。Profile Key 需放在請求的 header 中。對於 User Profile 的請求，API Key 同樣必須放在 header 中。

Premium 方案在請求 header 中應僅使用 API Key。Business 與 Enterprise 方案在代表 User Profile 進行操作時，應在請求 header 中使用 Profile Key。

API Key 格式

Authorization: Bearer API_KEY，將 API_KEY 替換為你的 Primary Profile API Key，可以在 Ayrshare Dashboard 中找到。

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

你的密鑰 API Key 可在 Ayrshare dashboard 中，左側導覽面板的 API Key 頁面取得。例如，如果你的 API Key 是 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA你的 header 應包含：Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Profile Key 格式

Profile Key 用於代表 User Profile 進行操作。此功能僅適用於 Business 或 Enterprise 方案。 Profile-Key: PROFILE_KEY，將 PROFILE_KEY 替換為某使用者的 Profile Key。 若要代表 User Profile 進行操作，header 中必須包含 Profile Key。若缺少 Primary Profile API Key，或在 header 中以 Profile Key 取代 API Key，都會導致錯誤。以下是如何為 API 請求組合這些 header：

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

可在 Ayrshare Dashboard 中左側導覽面板的 Profile Key 頁面找到 Profile Key。先在 User Profile 頁面切換到你想使用的 Profile。此外，Create a User Profile 端點的回應中也會回傳 Profile Key。之後便可以在請求的 header 中使用 Profile Key：例如，如果你的 Profile Key 是 AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA你的 header 應同時包含 API 與 Profile Key：Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

X/Twitter BYO 憑證

自 2026 年 3 月 31 日起，所有透過 Ayrshare 進行的 X/Twitter 操作都需要你自己的 OAuth 1.0a 憑證。透過 OAuth 連結你的 X 帳號後，對於任何以 X/Twitter 為目標的請求，除了 Authorization（以及選填的 Profile-Key）header 外，還需一併傳入以下 2 個 header：

Header	說明
`X-Twitter-OAuth1-Api-Key`	你的 OAuth 1.0a API Key（Consumer Key）
`X-Twitter-OAuth1-Api-Secret`	你的 OAuth 1.0a API Key Secret（Consumer Secret）

自 2026 年 3 月 31 日起，這些 header 為必填。若未提供有效的 BYO 憑證，X/Twitter 端點的請求將被拒絕。

一組金鑰組，用於每一個請求。 你為每個 Ayrshare 帳號建立一個 X Developer App，並在每個以 X 為目標的請求中使用相同的 X-Twitter-OAuth1-Api-Key 與 X-Twitter-OAuth1-Api-Secret 值，不論該請求是針對哪個子 profile（Profile-Key）。你不需要為每位客戶或每位終端使用者產生或輪替金鑰。

詳細的步驟、程式碼範例與疑難排解請參閱 X BYO Key 設定指南。透過 MCP Server 驅動 X/Twitter 時也適用同樣的兩個 header — 請參閱 Connect & Setup。

Content Type

除非端點另有指定，Content Type 應一律設為 Content-Type: "application/json"。

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

壓縮

Ayrshare 所有 API 請求皆支援壓縮。若要啟用壓縮，請將 Accept-Encoding header 設為 deflate, gzip, br。

  Accept-Encoding: "deflate, gzip, br"

當回應較大時（例如呼叫 /history 端點時），建議使用壓縮。

只有大於 1024 bytes（1KB）的回應才會被壓縮。
使用的壓縮順序為：先 Brotli（br），接著 gzip，最後 deflate。Brotli 是效率最高的壓縮演算法。
回應 header 會包含實際使用的內容編碼。例如：若使用 Brotli，則 content-encoding: br。
了解更多關於壓縮以及使用壓縮的好處，請參閱 Ayrshare Blog。

別忘了依 content encoding 正確解壓縮回應。

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -H "Accept-Encoding: deflate, gzip, br" \ 
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json",
  "Accept-Encoding" => "deflate, gzip, br"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

ID 類型

API 會回傳多種類型的 ID，可用於不同的端點：

Ayrshare Post ID

此 ID 由 Ayrshare 產生，並由 /post 端點在 id 欄位中回傳。此 ID 讓你能輕鬆跨社群網路取得該貼文的分析、對該貼文新增留言、刪除該貼文等。這是你最常會使用的 ID。每個社群網路都會為貼文與留言指派自己的唯一 ID。這些 ID 會在 /post 或 /comments 端點的 postIds 欄位中回傳。你可以使用這些 ID（或直接從社群網路取得的 ID）來取得資料，例如透過 analytics social post ID。

Ayrshare Comment ID

此 ID 由 Ayrshare 產生，並由 /comments 端點在 id 欄位中回傳。此 ID 讓你能輕鬆跨社群網路取得該留言的分析、回覆該留言、刪除該留言等。這是你最常會使用的 ID。當你想取得透過 Ayrshare 發布的特定留言細節時常會用到。每個社群網路都會為留言指派自己的唯一 ID。這些 ID 會在 GET /comments 端點的 commentId 欄位中回傳。當你想取得非透過 Ayrshare 發布的特定留言細節時常會用到。

錯誤代碼

錯誤會以標準 HTTP 狀態碼回傳。更多資訊：

HTTP 狀態碼

進一步了解 HTTP 狀態碼

REST API 回應中會包含各類型呼叫特定的詳細錯誤資訊。更多資訊：

Ayrshare 錯誤代碼

進一步了解 Ayrshare 特定的錯誤代碼

時間戳格式

Ayrshare 使用 Zulu Time（又稱 UTC，Coordinated Universal Time）或 ISO 8601 格式的日期字串，以精確、無歧義地表示不同時區的時間。例如使用 YYYY-MM-DDThh:mm:ssZ 格式，並以 2026-07-08T12:30:00Z 的形式傳送。更多範例請參閱 utctime。你可以使用你偏好的程式語言將 UTC 格式轉換為本地時間。例如以 JavaScript：

const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};

Postman

你可以使用 Postman 來測試你的 REST API 呼叫。

Postman

了解如何搭配我們的 API 使用 Postman

隨機貼文、圖片與影片

請參閱快速入門指南，了解如何在測試時發送隨機貼文、圖片或影片。

套件

我們提供 Node.js 與 Python 套件，以及 Bubble.io、Airtable 與 Make 的指南，讓你更輕鬆地進行 RESTful 呼叫。

Node NPM 套件

使用我們的 NodeJS 套件進行整合

Python PyPI 套件

使用我們的 Python 套件進行整合

Airtable 指南

了解如何搭配 Airtable 使用 Ayrshare

Bubble 外掛與指南

了解如何搭配 Bubble.io 使用 Ayrshare

Make 指南

了解如何搭配 Make 使用 Ayrshare

Notion 指南

了解如何搭配 Notion 使用 Ayrshare

FlutterFlow 指南

了解如何搭配 FlutterFlow 使用 Ayrshare

Retool 指南

了解如何搭配 Retool 使用 Ayrshare

​主要功能

​Business Plan 與 Launch Plan

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​觀看 Social API 使用示範

​Social API 示範

Social API 示範

​Base URL

​授權

​API Key 格式

​Profile Key 格式

​X/Twitter BYO 憑證

​Content Type

​壓縮

​ID 類型

​Ayrshare Post ID

​Social Post ID

​Ayrshare Comment ID

​Social Comment ID

​錯誤代碼

HTTP 狀態碼

Ayrshare 錯誤代碼

​時間戳格式

​Postman

Postman

​隨機貼文、圖片與影片

​套件

Node NPM 套件

Python PyPI 套件

Airtable 指南

Bubble 外掛與指南

Make 指南

Notion 指南

FlutterFlow 指南

Retool 指南

主要功能

Business Plan 與 Launch Plan

Ads API

Messages API

Max Pack

觀看 Social API 使用示範

Social API 示範

Base URL

授權

API Key 格式

Profile Key 格式

X/Twitter BYO 憑證

Content Type

壓縮

ID 類型

Ayrshare Post ID

Social Post ID

Ayrshare Comment ID

Social Comment ID

錯誤代碼

時間戳格式

Postman

隨機貼文、圖片與影片

套件