Ayrshare API 概述 - Ayrshare API Documentation

社交媒体 REST API 通过单一统一的接口为开发者提供对多个社交网络的编程访问。通过 Ayrshare 的社交 API，你可以管理社交媒体活动，包括创建和删除帖子、检索分析、参与评论和评价、管理直接消息、创建 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 计划，请参见 Business 计划概述、Launch 计划概述和 /profiles API 端点。

关键功能

支持 13 个社交网络。
使用你唯一的 API Key 进行安全 API 访问。
安排到连接的社交媒体平台的定时发布。
基于预定义计划的自动发布。
支持图片和视频内容，包括 Reels、Stories 和 Spotlight。
删除已链接社交网络上的帖子。
全面的帖子互动分析（点赞、分享等）。
社交账户指标，包括关注者数量和人口统计数据。
评论管理：查看、添加和删除帖子评论。
可选的链接缩短，适用于帖子中的所有或特定 URL。
Unsplash 集成：添加特定图片或根据关键词随机选择。
使用相关关键词自动生成话题标签的选项。
帖子历史跟踪，包括非 Ayrshare 帖子。
评价管理：检索、回复和删除评价响应。
RSS feed 集成，用于自动化内容发布。
媒体库：上传和存储照片和视频以用于帖子。
社交帖子验证系统以保护你的社交账户安全。

Business 计划和 Launch 计划

Business 计划和 Launch 计划用于管理多个用户和客户的功能：

使用户能够将自己的社交媒体账户关联到你的平台。
使用 OAuth 实现安全的单点登录，实现快速账户关联。
通过 API 以编程方式创建和删除用户配置文件。
访问高级用户分析。
Webhook 支持实时更新。
在支持的平台上管理直接消息。
从现有帖子创建 Facebook 广告。

联系我们了解更多关于 Business 计划的信息。

Ads API

Ads API 允许你从现有帖子创建 Facebook 广告。

提升帖子以覆盖更多人群。
管理广告并跟踪表现。
分析广告支出并优化广告活动。

Ads API

探索 Ads API

Messages API

统一的 Messaging API 用于在主要社交媒体渠道（Facebook、Instagram 和 X）上与用户对话。

发送文本、图片和视频消息。
检索完整的对话历史记录。
设置自动消息响应。
通过 webhook 接收消息接收、消息反应、已读回执的实时更新。

该 API 通过集中管理多个社交媒体渠道的消息操作简化了用户互动。了解更多…

Messages API

探索统一消息 API

Max Pack

使用 Max Pack 附加包获取更多功能：

Max Pack

通过我们的 Max Pack 附加包解锁高级功能，如 AI 驱动的内容生成、增强的分析和扩展的平台支持。

观看如何使用社交 API

如果你使用 Node.js 构建，请观看此视频，了解如何连接并将帖子发布到 X 和 Facebook。

社交 API 演示

如果你使用 Node.js，请查看社交 API 演示代码，开始构建你自己的社交 API 集成。

社交 API 演示

探索我们的 Node.js 演示代码，快速启动你的社交 API 集成

Base URL

Ayrshare API 所有端点的基础 URL 相同。 https://api.ayrshare.com/api

授权

Ayrshare 通过在 HTTP header 中传递的 Authorization 令牌来验证 API 请求。请务必与 API Key 一起发送 Bearer。API Key 可以在 Ayrshare 仪表板中切换到你的 Primary Profile 找到。如果你是 Business 或 Enterprise 用户，你可以创建带有 Profile Key 的用户配置文件来管理多个客户。Profile Key 在你的请求 header 中使用。 API Key 也必须在用户配置文件的请求 header 中使用。

Premium 计划应该在请求的 header 中仅使用 API Key。Business 和 Enterprise 计划在代表用户配置文件进行交互时，应在请求的 header 中使用 Profile Key 。

API Key 格式

Authorization: Bearer API_KEY，将 API_KEY 替换为你的 Primary Profile API Key，可以在 Ayrshare 仪表板中找到。

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"}

在 Ayrshare 仪表板左侧导航面板中的 API Key 页面下获取你的密钥 API Key。例如，如果你的 API Key 是 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA你的 header 应该包含：Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Profile Key 格式

Profile Key 用于代表用户配置文件进行交互。仅适用于 Business 或 Enterprise 计划。 Profile-Key: PROFILE_KEY，将 PROFILE_KEY 替换为用户的 Profile Key。 在 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 仪表板左侧导航面板中的 Profile Key 页面下找到 Profile Key。在用户配置文件页面切换到你想要使用的配置文件。此外，Profile Key 也会在创建用户配置文件端点的响应中返回。然后你可以在请求的 header 中使用 Profile Key：例如，如果你的 Profile Key 是 AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA你的 header 应同时包含 API Key 和 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）

这些 header 在 2026 年 3 月 31 日之后是必需的。没有有效 BYO 凭据的 X/Twitter 端点请求将被拒绝。

一对密钥，用于每个请求。 你为每个 Ayrshare 账户创建一个 X Developer 应用，并在每个面向 X 的请求中使用相同的 X-Twitter-OAuth1-Api-Key 和 X-Twitter-OAuth1-Api-Secret 值，无论请求针对哪个子配置文件（Profile-Key）。你不需要为每个客户或每个最终用户生成或轮换密钥。

有关分步说明、代码示例和故障排除，请参见 X BYO Key 设置指南。通过 MCP Server 驱动 X/Twitter 时同样应用相同的两个 header — 参见连接与设置。

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 字节 (1KB) 的响应才会被压缩。
使用的压缩顺序：Brotli (br) 优先，然后是 gzip，最后是 deflate。Brotli 是最高效的压缩算法。
响应 header 包含所用的内容编码。例如：content-encoding: br 如果使用了 Brotli。
在 Ayrshare 博客中了解更多关于压缩以及使用压缩的好处。

不要忘记使用内容编码正确解压响应。

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 类型

返回的 ID 有多种类型，可用于各个端点：

Ayrshare Post ID

此 ID 由 Ayrshare 生成，并从 /post 端点的 id 字段返回。此 ID 使在社交网络上获取帖子的分析、为帖子添加评论、删除帖子等操作变得容易。这是你最常使用的 ID。

社交帖子 ID

每个社交网络为其帖子和评论分配自己的唯一 ID。这些 ID 在 /post 或 /comments 端点的 postIds 字段中返回。你可以使用这些 ID 或直接从社交网络获取的 ID 来检索数据，例如使用 analytics 社交帖子 ID。

Ayrshare 评论 ID

此 ID 由 Ayrshare 生成，并从 /comments 端点的 id 字段返回。此 ID 使在社交网络上获取评论的分析、为评论添加回复、删除评论等操作变得容易。这是你最常使用的 ID。如果你想获取通过 Ayrshare 发布的特定评论的详细信息，这通常很有用。

社交评论 ID

每个社交网络为其评论分配自己的唯一 ID。这些 ID 在 GET /comments 端点的 commentId 字段中返回。如果你想获取通过 Ayrshare 之外发布的特定评论的详细信息，这通常很有用。

错误代码

错误将返回标准 HTTP 状态代码。更多信息：

HTTP 状态代码

了解更多关于 HTTP 状态代码

详细的错误在每种调用类型特定的 REST API 响应中。更多信息：

Ayrshare 错误代码

了解更多关于 Ayrshare 特定的错误代码

时间戳格式

Ayrshare 使用 Zulu 时间（也称为 UTC 协调世界时）或 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

了解如何将 Postman 与我们的 API 一起使用

随机帖子、图片和视频

请查看快速入门指南，了解在测试时如何发送随机帖子、图片或视频。

软件包

我们提供 Node.js 和 Python 软件包，以及 Bubble.io、Airtable 和 Make 的指南，使 RESTful 调用更加简单。

Node NPM 软件包

使用我们的 NodeJS 软件包进行集成

Python PyPI 软件包

使用我们的 Python 软件包进行集成

Airtable 指南

了解如何将 Ayrshare 与 Airtable 一起使用

Bubble 插件和指南

了解如何将 Ayrshare 与 Bubble.io 一起使用

Make 指南

了解如何将 Ayrshare 与 Make 一起使用

Notion 指南

了解如何将 Ayrshare 与 Notion 一起使用

FlutterFlow 指南

了解如何将 Ayrshare 与 FlutterFlow 一起使用

Retool 指南

了解如何将 Ayrshare 与 Retool 一起使用

​关键功能

​Business 计划和 Launch 计划

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​观看如何使用社交 API

​社交 API 演示

社交 API 演示

​Base URL

​授权

​API Key 格式

​Profile Key 格式

​X/Twitter BYO 凭据

​Content Type

​压缩

​ID 类型

​Ayrshare Post ID

​社交帖子 ID

​Ayrshare 评论 ID

​社交评论 ID

​错误代码

HTTP 状态代码

Ayrshare 错误代码

​时间戳格式

​Postman

Postman

​随机帖子、图片和视频

​软件包

Node NPM 软件包

Python PyPI 软件包

Airtable 指南

Bubble 插件和指南

Make 指南

Notion 指南

FlutterFlow 指南

Retool 指南

关键功能

Business 计划和 Launch 计划

Ads API

Messages API

Max Pack

观看如何使用社交 API

社交 API 演示

Base URL

授权

API Key 格式

Profile Key 格式

X/Twitter BYO 凭据

Content Type

压缩

ID 类型

Ayrshare Post ID

社交帖子 ID

Ayrshare 评论 ID

社交评论 ID

错误代码

时间戳格式

Postman

随机帖子、图片和视频

软件包