Ayrshare API 概要 - Ayrshare API Documentation

Social Media 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 Plan 概要、Launch Plan 概要、/profiles API エンドポイントを参照してください。

主な機能

13 のソーシャルネットワークに対応。
あなた固有の API Key による安全な API アクセス。
連携済みのソーシャルメディアプラットフォームへの予約投稿。
定義済みスケジュールに基づく自動投稿。
Reels、Stories、Spotlight を含む画像・動画コンテンツのサポート。
連携済みソーシャルネットワーク上の投稿の削除。
包括的な投稿エンゲージメントアナリティクス（いいね、シェアなど）。
フォロワー数や人口統計データを含むソーシャルアカウントメトリクス。
コメント管理: 投稿コメントの閲覧、追加、削除。
投稿内のすべてまたは特定の URL に対する任意のリンク短縮。
Unsplash 連携: 特定の画像を追加するか、キーワードに基づいてランダムに選択。
関連キーワードを使ったハッシュタグの自動生成オプション。
Ayrshare 経由でない投稿を含む、投稿履歴の追跡。
レビュー管理: レビューへの返信、応答の取得と削除。
自動コンテンツ投稿のための RSS フィード連携。
メディアライブラリ: 投稿で使用する写真や動画のアップロードと保存。
ソーシャルアカウントを安全に保つための Social Post Verification System。

Business Plan と Launch Plan

複数のユーザーやクライアントを管理するための Business Plan および Launch Plan の機能：

ユーザーが自分のソーシャルメディアアカウントをあなたのプラットフォームに連携できるようにする。
迅速なアカウント連携のための OAuth を使用したセキュアなシングルサインオン。
API を介してプログラム的にユーザープロファイルを作成・削除。
高度なユーザーアナリティクスへのアクセス。
リアルタイム更新のための Webhook サポート。
対応プラットフォーム全体でのダイレクトメッセージ管理。
既存投稿からの Facebook 広告作成。

Business Plan の詳細については、お問い合わせください。

Ads API

Ads API を使うと、既存の投稿から Facebook 広告を作成できます。

投稿をブーストしてより多くの人にリーチ。
広告の管理とパフォーマンスの追跡。
広告費の分析とキャンペーンの最適化。

Ads API

Ads API を探索する

Messages API

Facebook、Instagram、X などの主要なソーシャルメディアチャネルにわたって会話でユーザーを引き込むための、統一された Messaging API。

テキスト、画像、動画メッセージの送信。
会話履歴全体の取得。
自動メッセージ応答の設定。
受信メッセージ、メッセージへのリアクション、既読レシートに関する Webhook 経由のリアルタイム更新の受信。

この API は、複数のソーシャルメディアチャネルのメッセージング操作を集中化することにより、ユーザーエンゲージメントを簡素化します。詳しく見る…

Messages API

統一メッセージング API を探索する

Max Pack

Max Pack アドオンでさらに多くの機能を手に入れましょう：

Max Pack

Max Pack アドオンで、AI 搭載のコンテンツ生成、拡張アナリティクス、拡張プラットフォームサポートなどの高度な機能をアンロックしましょう。

ソーシャル API の使い方を動画で見る

Node.js で開発している方は、この動画で X と Facebook への連携と投稿公開の方法をご覧ください。

ソーシャル API デモ

Node.js を使用している場合は、ソーシャル API デモコードを参考にして、独自のソーシャル API 統合の構築を開始できます。

Social API Demo

Node.js デモコードを見て、あなたのソーシャル API 統合を始めましょう

Base URL

Ayrshare API のベース URL は、すべてのエンドポイントで同じです。 https://api.ayrshare.com/api

認証

Ayrshare は、HTTP ヘッダーで渡される Authorization トークン経由で API リクエストを認証します。API Key には必ず Bearer を付けて送信してください。API Key は、Primary Profile に切り替えることで Ayrshare ダッシュボードで確認できます。 Business または Enterprise ユーザーの場合、複数のクライアントを管理するための Profile Key を持つ User Profile を作成できます。Profile Key はリクエストのヘッダーで使用します。 User Profile の場合、リクエストのヘッダーで API Key も併せて使用する必要があります。

Premium プランのユーザーはリクエストのヘッダーで API Key のみを使用してください。Business および Enterprise プランでは、User Profile を代理して操作する場合、リクエストのヘッダーで Profile Key を使用してください。

API Key の形式

Authorization: Bearer API_KEY の API_KEY 部分を、Ayrshare ダッシュボードで見つけられる Primary Profile の API Key に置き換えてください。

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 の場合、ヘッダーには次を含める必要があります：Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Profile Key の形式

Profile Key は User Profile を代理して操作するために使用されます。これは Business または Enterprise プランでのみ利用可能です。 Profile-Key: PROFILE_KEY の PROFILE_KEY 部分を、ユーザーの Profile Key に置き換えてください。 User Profile を代理して操作するには、ヘッダーに Profile Key を含める必要があります。 Primary Profile の API Key が欠落している、またはヘッダーで API Key の代わりに Profile Key を使用すると、エラーになります。以下は API リクエストのヘッダー構成例です：

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 を見つけることができます。 User Profile ページで使用したいプロファイルに切り替えてください。また、Profile Key は Create a User Profile エンドポイントのレスポンスでも返されます。これでリクエストのヘッダーで Profile Key を使用できます：たとえば Profile Key が AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA の場合、ヘッダーには 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）ヘッダーとともにこの 2 つのヘッダーを渡してください：

ヘッダー	説明
`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 日以降必須となります。有効な BYO 認証情報のない X/Twitter エンドポイントへのリクエストは拒否されます。

1 つの Key ペアをすべてのリクエストで使用。 Ayrshare アカウントごとに 1 つの X Developer App を作成し、どのサブプロファイル（Profile-Key）のリクエストかに関係なく、X を対象とするすべてのリクエストで同じ X-Twitter-OAuth1-Api-Key および X-Twitter-OAuth1-Api-Secret の値を使用します。顧客やエンドユーザーごとに Key を生成またはローテーションする必要はありません。

ステップバイステップの手順、コード例、およびトラブルシューティングについては X BYO Key Setup Guide を参照してください。 MCP Server 経由で X/Twitter を駆動する場合も同じ 2 つのヘッダーが適用されます。詳細は 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 ヘッダーを deflate, gzip, br に設定してください。

  Accept-Encoding: "deflate, gzip, br"

これは /history エンドポイントのような大きなレスポンスを呼び出す際に推奨されます。

圧縮されるのは 1024 バイト（1KB）を超えるレスポンスのみです。
使用される圧縮の順序: 最初に Brotli (br)、次に gzip、最後に deflate。Brotli は最も効率的な圧縮アルゴリズムです。
レスポンスヘッダーには使用されたコンテンツエンコーディングが含まれます。例: Brotli が使用された場合は content-encoding: br。
圧縮の詳細と圧縮を使用する利点については 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 は /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 Status Codes

HTTP ステータスコードについて詳しく見る

詳細なエラーは、各種類の呼び出しに固有の REST API レスポンスに含まれます。詳細情報：

Ayrshare Error Codes

Ayrshare 固有のエラーコードについて詳しく見る

タイムスタンプ形式

Ayrshare では、異なるタイムゾーンにまたがる正確で曖昧さのない時間参照のために、Zulu Time（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

API での Postman の使い方を学ぶ

ランダムな投稿、画像、動画

テスト時にランダムな投稿、画像、動画を送信する方法についてはクイックスタートガイドをご覧ください。

パッケージ

Node.js および Python パッケージ、Bubble.io、Airtable、Make のガイドを用意しており、RESTful 呼び出しをより簡単に行えます。

Node NPM Package

NodeJS パッケージを使って統合する

Python PyPI Package

Python パッケージを使って統合する

Airtable Guide

Airtable で Ayrshare を使う方法を学ぶ

Bubble Plugin & Guide

Bubble.io で Ayrshare を使う方法を学ぶ

Make Guide

Make で Ayrshare を使う方法を学ぶ

Notion Guide

Notion で Ayrshare を使う方法を学ぶ

FlutterFlow Guide

FlutterFlow で Ayrshare を使う方法を学ぶ

Retool Guide

Retool で Ayrshare を使う方法を学ぶ

​主な機能

​Business Plan と Launch Plan

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​ソーシャル API の使い方を動画で見る

​ソーシャル API デモ

Social API Demo

​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 Status Codes

Ayrshare Error Codes

​タイムスタンプ形式

​Postman

Postman

​ランダムな投稿、画像、動画

​パッケージ

Node NPM Package

Python PyPI Package

Airtable Guide

Bubble Plugin & Guide

Make Guide

Notion Guide

FlutterFlow Guide

Retool Guide

主な機能

Business Plan と Launch Plan

Ads API

Messages API

Max Pack

ソーシャル API の使い方を動画で見る

ソーシャル 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

ランダムな投稿、画像、動画

パッケージ