Post API 概要

post エンドポイントを使用すると、Bluesky、Facebook、Google Business Profile、Instagram、LinkedIn、Pinterest、Reddit、Snapchat、Telegram、TikTok、X/Twitter、YouTube のソーシャルネットワークに投稿できます。投稿のスケジューリング、自動ハッシュタグの追加、自動投稿スケジュールなど、投稿をカスタマイズするための多くのオプションがあります。複数のステークホルダーが公開前に投稿を承認する必要がある場合、しばしばエージェンシーで利用されます。投稿の公開は /post POST エンドポイントから開始します。

承認ワークフロー

公開ワークフローで投稿の送信前に承認が必要な場合は、requiresApproval フィールドを true に設定します。これは approved パラメーターが true に設定されるまで投稿を一時停止することと同等です。

承認ワークフローの例

投稿は approved パラメーターが /post PATCH エンドポイント経由で true に設定されるまで「awaiting approval」ステータスになります。

パラメーターを指定して公開

requiresApproval フィールドを true にして /post エンドポイントで投稿を公開します。scheduleDate などの標準パラメーターも含めることができます。

ステータスは承認待ち

投稿は「awaiting approval」ステータスになり、承認されるまで保留されます。

投稿を承認

/post PATCH 操作で approved フィールドを true に設定して投稿を更新します。投稿はスケジュール時刻に送信されるようになります。

ノートを使用

オプション: 参照用に投稿に notes を設定します。たとえば誰が投稿を承認する必要があるかなど。

Publish the Post with Approval

{
  "requiresApproval": true,
  "notes": "need approval by John Smith" // optional
}

scheduleDate が含まれており、その日付が過去の場合、投稿は承認と同時に即座に公開されます。

承認ワークフローの動画

承認ワークフローの例については以下の動画を参照してください。

自動ハッシュタグ

投稿に最も関連性の高いハッシュタグを追加します。 autoHashtag はオブジェクトまたは Boolean 値です。以下のパラメーターがあります:

max: (オプション)追加するハッシュタグの整数、範囲 1〜10。デフォルト 2。
position: (オプション)文字列 “auto” または “end”。Auto は投稿内または末尾にハッシュタグを追加します。“end” は末尾にのみハッシュタグを追加します。

有料プランが必要です。

{
  "hashtags": {
    "max": 3, // optional: Integer range 1-10
    "position": "auto" // optional: String "auto" or "end"
  }
}

上記オプションを送信しない場合は、オブジェクトの代わりに Boolean 値 true を渡します。

{
  "autoHashtag": true
}

自動リポスト

コンテンツを定期的な間隔で複数回自動的にリポストし、オーディエンスに常に新鮮で目に留まるエバーグリーンなコンテンツを作成します。有料プランが必要です。パラメーター:

repeat: (必須)コンテンツをリポストする回数。1〜10 の間である必要があります。
days: (必須)各リポスト間の日数。最低 2 日である必要があります。
startDate: (オプション)リポストスケジュールを開始する日時。ISO-8601 UTC 形式。指定しない場合、最初の投稿は即座に公開されます。トップレベルの scheduleDate パラメーターの代わりに startDate パラメーターを使用してください。

Auto Repost

{
  "repeat": 2, // min 2, max 10
  "days": 5, // min 2
  "startDate": "2021-07-08T12:30:00Z"
}

レスポンスには将来スケジュールされたすべてのリポストと、各リポストの autoRepostId が含まれます。

Auto Repost Response

{
  "status": "scheduled",
  "scheduleDate": "2025-06-13T12:30:00.000Z",
  "id": "eIT96IYEodNuzU4oMmwG",
  "refId": "9abf1426d6ce9122ef11c72bd",
  "autoRepostId": "F5wdoaOAAGtDQVciExSxL",
  "post": "The most important things are the hardest to say - Stephen King"
}

自動リポストの作成時、その投稿シリーズを追跡するために ID autoRepostId が割り当てられます。投稿のすべての自動リポストは、autoRepostId を使用して History call で取得できます。リポストを削除する必要がある場合は、投稿 ID を指定して DELETE call を使用できます。

重要: 自動リポストを使用する場合、アカウント制限を回避するために各ソーシャルネットワークの投稿頻度ガイドラインに従ってください。注意: autoRepost 機能は scheduleDate と一緒に使用できません。両方のパラメーターを含めると、scheduleDate が優先され、autoRepost は無視されます。代わりに startDate パラメーターを使用してください。

First Comment

投稿が公開された後、メディア付きで自動的に最初のコメントを追加します。TikTok の場合、コメントは動画の処理が完了するまで延期されます(First Comment 処理時間を参照)。自分自身のソーシャルメディア投稿に最初のコメントを投稿することで、エンゲージメントを促進し、その後の議論の雰囲気を設定できます。

{
  "firstComment": {
    "comment": "My first comment", // required
    "mediaUrls": ["https://..."] // Facebook, LinkedIn, and X/Twitter only
  }
}

First Comment 処理時間

ほとんどのソーシャルネットワークでは、当社のシステムが (1) 元の投稿が完全に公開されるのを待ち、(2) 公開された投稿にコメントを追加する必要があるため、API レスポンスが遅延します。この逐次処理により、約 20 秒の遅延が追加されます。 TikTok は異なる方法で処理されます。 TikTok は動画を非同期で処理するため、TikTok の post.publish.publicly_available webhook が実際の動画 ID を解決するまで、投稿 id は "pending" です(TikTok Processing を参照)。したがって、/post レスポンスは即座に status: "pending" の TikTok first comment を返し、TikTok の処理が完了して tikTokPublished Scheduled Action webhook が発火すると、コメントは自動的に投稿されます。TikTok は処理時間を保証していないため、固定の遅延はありません。 TikTok に関する重要な注意事項: TikTok で first comment が正常に機能するには、投稿の visibility パラメーターが public に設定されている必要があります。非公開動画は publicly_available webhook を受信しないため、first comment は投稿できません。その場合、Ayrshare は保留したままにするのではなく、コメントエラーを返します。

冪等な投稿

冪等性は、リクエストが誤って複数回送信されても 1 回だけ実行されることを保証するオプション機能です。 API を使用してコンテンツを投稿する際、リクエストボディに idempotencyKey パラメーターをオプションで含めることで、操作を一意に識別できます。これにより、重複した投稿を作成するリスクなく、post リクエストを安全に再試行できます。冪等性を使用するには、/post POST リクエストの JSON ボディに idempotencyKey パラメーターを追加します:

Idempotency Key

{
  "idempotencyKey": "Unique Key"
}

idempotencyKey の値は User Profile ごとに一意の文字列である必要があります。指定された User Profile に対して同じ idempotencyKey でリクエストが行われた場合、投稿の状態(success、error、pending、または deleted)に関係なく、重複キーが見つかったことを示すエラーが返されます。

重複を保存してチェックするために、API はまず POST リクエストを受け取って処理する必要があります。ただし、同じ idempotencyKey の複数の POST リクエストが同時に送信されるか、同じ投稿時刻にスケジュールされている場合、API は重複キーを検出できない場合があります。これは、API が任意の単一リクエストから冪等性キーを登録する前に、これらの同時または同時刻にスケジュールされたリクエストを並行して処理するためです。その結果、同時送信または同時実行のスケジュール投稿のシナリオでは、重複した冪等キーが捕捉される保証はありません。

冪等性を使用することは、失敗したリクエストの再試行やネットワーク問題の処理時に、意図しない重複投稿の作成を防ぐのに役立ちます。ただし、潜在的な障害を適切に処理するために、アプリケーションで適切なエラーハンドリングと再試行メカニズムを実装することを引き続きお勧めします。

画像と動画の要件

画像と動画の投稿には各ネットワークで異なる要件がありますが、心配は不要です。当社のシステムは送信前に投稿を検証するため、何か問題があればエラー応答が返されます。画像と動画のガイドラインの詳細については、以下のリンクを参照してください。

画像と動画のガイドライン

有効な URL

メディア URL が有効で、直接メディアにアクセスできることを確認してください。最初のテストとして、ブラウザで URL を試してください。ブラウザで画像がロードされない、またはダウンロードできない場合、ほぼ確実に失敗します。たとえば、DropBox Web アプリを開く DropBox URL は動作しません。

Google Drive の共有 URL や Dropbox の共有 URL をお持ちの場合は、投稿またはコメントを公開する際に mediaUrls パラメーターにその URL をそのまま使用できます。Ayrshare が自動的に共有 URL をダウンロードリンクに変換します。

HEAD リクエストを行うことで、メディア URL を検証します。ホスティングプロバイダーが HEAD リクエストをブロックしていないことを確認してください。そうでないと投稿は 403 エラーで失敗します。たとえば、メディア URL への HEAD リクエストは次のとおりです:

Fetch HEAD Request

const run = async () => {
  const url = "https://img.ayrshare.com/012/gb.jpg";
  return await fetch(url, {
    method: "HEAD"
  })
    .then((res) => {
      if (res.ok) {
        return console.log("Success:", res.status, res.statusText);
      } else {
        return console.error("Error:", res.status, res.statusText, res);
      }
    })
    .catch((error) => {
      return console.error("Error Catch:", error);
    });
};

run();

自動メディア保護

Ayrshare には、投稿中に特定のメディア配信の問題を検出して解決できる組み込みのメディア保護機能があります。投稿が成功しても、コンテンツの問題が検出されて解決された場合、postIds[] の各対応エントリにオプションの contentIssues オブジェクトが含まれるため、根本的な問題を特定して修正できます:

{
    "postIds": [
        {
            "status": "success",
            "platform": "instagram",
            "id": "17878176260289172",
            "postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
            "contentIssues": {
                "originMediaHostFailed": true,
                "details": ["Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."]
            }
        }
    ]
}

レスポンスに originMediaHostFailed が表示される場合は、メディアホスティング設定を確認してください。一般的な原因と解決策については Meta Media Crawler Blocked を参照してください。

スペースと特殊文字

メディア URL には以下を避けることをお勧めします:

URL 内のスペース。
URL 内の URL エンコードされたスペース。
URL 内の特殊文字。URL エンコードされていても、é などのアクセント記号など。

たとえば:

https://img.ayrshare.com/012/test .webp

この URL は test .webp のスペースが原因で失敗します。また、%20 などの URL エンコードされたスペースを URL に使用することもお勧めしません。一部のソーシャルネットワークでも問題が発生する可能性があります。そして、この Unsplash 画像:

https://unsplash.com/photos/a-house-in-the-middle-of-a-field-with-trees-in-the-background-znbmh2-cIj0

この Unsplash 画像は、画像に直接アクセスするのではなく Web アプリを表示しているため失敗します。

ファイル名と URL のサニタイズ

/[^a-z0-9\/\.]/gi のような正規表現でファイル名をサニタイズできます。

const sanitizeFileName = (url) => url.replace(/[^a-z0-9\/\.]/gi, "_");
sanitizeFileName("tést .webp"); // t_st_.webp

または URL をサニタイズします

const sanitizeUrl = (url) => {
  const [protocol, rest] = url.split("://");
  const [domain, ...path] = rest.split("/");
  const sanitizedPath = path.join("/").replace(/[^a-z0-9\/\.]/gi, "_");
  return `${protocol}://${domain}/${sanitizedPath}`;
};

// Output: https://img.ayrshare.com/012/t_st_.webp
sanitizeUrl("https://img.ayrshare.com/012/tést .webp");

追加情報

自身でホストしている場合、URL が外部からアクセス可能で、特別な権限が必要ないことを確認してください。
AWS S3 などの署名付き URL のように、拡張子が不明な動画を処理する方法については以下を参照してください。
S3 などの署名付き URL を使用している場合、URL の有効期限を少なくとも 7 日に設定することをお勧めします。これにより、投稿の公開に関するご質問へのサポートが可能になります。
verify media tools でメディア URL が存在するかテストしてください。

ダウンロード速度

メディアホスティングが高速な接続、特にダウンロード速度が速いことを確認してください。メディアホスティングのパフォーマンスは pingdom でテストできます。少なくとも B 評価 をお勧めします。

動画の拡張子

URL が mp4 などの既知の動画拡張子で終わらない場合、投稿で isVideo: true フィールドを使用して mediaUrl が動画であることを指定できます。Ayrshare は MOV などのファイルタイプを判断しようとします。ただし、ソーシャルネットワークでの成功率が高いため、動画ファイルは mp4 などの既知の拡張子で明示的に終わることをお勧めします。

画像または動画のみ

いくつかのソーシャルネットワークは、投稿テキストなしでメディアを送信することをサポートしています。投稿テキストを含めない場合は、空の文字列 post: "" を送信します。以下のソーシャルネットワークが投稿テキストなし/空白テキストをサポートします: Facebook, Instagram, LinkedIn, Threads, TikTok, X/Twitter。

画像と動画のテスト

テストを高速化するためにランダムなテキストとランダムな画像または動画を生成することを検討してください。テスト投稿ごとに新しいアイデアを考える必要はもうありません!

改行

投稿内で改行(新しい行)を入れる場合は、非表示の改行 \u2063\n を使用します。たとえば、This is a new\u2063\nline.新しい改行がお好みの言語でどのように翻訳されるかを確認するために、Postman で試すこともお勧めします。たとえば、PHP はしばしば \n だけを使用します。一部のソーシャルネットワークは、現在投稿テキストでの改行をサポートしていません。

マルチプラットフォーム投稿とメディア

この機能により、単一の API 呼び出しで異なるソーシャルネットワークに合わせて投稿コンテンツとメディアをカスタマイズできます。post と mediaUrls フィールドにオブジェクトを使用することで、各プラットフォームに固有のテキストや画像を指定できます。

post と/または mediaUrls フィールドにオブジェクト構造を使用します。
プラットフォーム名をキーとして使用し、プラットフォーム固有のコンテンツを指定します。
明示的に指定されていないプラットフォームで使用するコンテンツを default キーで含めます。

{
  "post": {
    "instagram": "Great IG pic!",
    "facebook": "Great FB pic!",
    "default": "Great default pic!"
  },
  "platforms": ["instagram", "facebook", "linkedin"],
  "mediaUrls": {
    "instagram": "https://img.ayrshare.com/012/gb.jpg",
    "linkedin": "https://img.ayrshare.com/012/gb.jpg",
    "default": "https://img.ayrshare.com/012/gb.jpg"
  }
}

上記の例では:

Instagram は固有のテキストと画像 URL を使用します。
Facebook は固有のテキストとデフォルトの画像 URL を使用します。
LinkedIn はデフォルトのテキストと固有の画像 URL を使用します。

異なるプラットフォームに複数の画像を投稿する必要がある場合は、このマルチプラットフォーム構造を使用する代わりに、プラットフォームごとに別々の投稿を作成してください。

Profile Key

ユーザーの Profile Key をボディパラメーターとして提供し、レスポンスに追加データを含めることで、ユーザーに代わって投稿します。Business または Enterprise プランが必要です。

Profiles

リッチテキスト投稿

”𝓗𝓮𝓵𝓵𝓸, how about a little 𝗯𝗼𝗹𝗱 𝘁𝗲𝘅𝘁 and 𝘪𝘵𝘢𝘭𝘪𝘤𝘴 𝘵𝘦𝘹𝘵 and an x₂?” のようなリッチテキストを追加できます。Twitter、Facebook、LinkedIn、Telegram、Instagram などのネットワークでリッチテキストを使用できます。 Reddit に投稿する場合は、Reddit-flavored Markdown フォーマットを使用してください。 HTML 要素を使用してリッチテキストのタイプを指定し、Unicode に変換されます。たとえば:

{
    "post": "<var>Hello</var>, how about a little <b>bold text</b> and <i>italics text</i> and an x<sub>2</sub>?"
    "platforms": ["twitter"]
}

HTML 要素

HTML	例
<b>Nice One!</b>	Nice One!
<strong>Hello, world!</strong>	Hello, world!
<em>World</em>	World
normal <i>italics <b>bold italics</b></i>	normal italics bold italics
`<b>Hello</b>, world!`	`Hello, world!`
`<b>Hello</b>, world!`	`Hello``, world!`
<samp>123</samp>	𝟷𝟸𝟹
<var>Hello</var>	𝓗𝓮𝓵𝓵𝓸
x<sub>2</sub>	x₂
x<sup>2</sup>	x²

CSS コード

コード	例	結果
\u00B0	It’s 25\u00B0C today!	It’s 25°C today!
\u2063\n	This is a new\u2063\nline.	This is a new line.

投稿のスケジューリング

スケジュール投稿の作成

scheduleDate パラメーターに Zulu/UTC 形式の日時を指定することで、将来の投稿をスケジュールできます。Zulu 時間(Coordinated Universal Time (UTC) とも呼ばれる)は、世界標準の時刻です。たとえば、YYYY-MM-DDThh:mm:ssZ 形式で 2026-07-08T12:30:00Z として送信します。その他の例については utctime を参照してください。

{
  "post": "Hello, world!",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["facebook", "instagram"],
  "scheduleDate": "2023-07-08T12:30:00Z"
}

現地時間を Zulu/UTC 時間に変換する方法については、https://www.utctime.net/ を参照してください。スケジュール日時が過去の場合、投稿は即座に送信されます。

スケジュール投稿に mediaUrl が含まれている場合、スケジュールされた公開時刻にメディアが利用可能である必要があります。たとえば、投稿が 2026 年 3 月 5 日に公開されるようにスケジュールされている場合、メディアは 2026 年 3 月 5 日に利用可能である必要があります。

スケジュール投稿と即時投稿のエラーハンドリング即時投稿とスケジュール投稿では、検証エラーの処理方法に重要な違いがあります:

即時投稿
- scheduleDate なしで即座に公開する場合、1 つのプラットフォームが検証チェックに失敗しても、他のプラットフォームは処理を続行します。たとえば、投稿が Twitter の文字制限を超えていても Facebook と Instagram では有効な場合、投稿は Twitter では失敗しますが、Facebook と Instagram には公開されます。
スケジュール投稿
- scheduleDate で将来の公開のために投稿をスケジュールする場合、投稿がスケジュールされる前にすべてのプラットフォームが初期検証チェックに合格する必要があります。いずれかのプラットフォームがこれらの事前検証チェックに失敗すると、スケジュール操作全体が拒否され、即座にエラーが返されます。
- ただし、プラットフォーム固有のエラーは、実際の投稿時刻まで検出されない場合があります。この場合、スケジュールされた投稿はすべてのプラットフォームへの公開を試み、個々のプラットフォームの失敗は他のプラットフォームに影響を与えることなく最終結果に報告されます。

スケジュール投稿のステータスを確認

スケジュールされた投稿のステータスを確認する方法はいくつかあります:

Webhook Scheduled Action をセットアップして、スケジュール投稿のステータスを自動的に受信します。これは Business プランで利用可能で、推奨される方法です。
投稿 ID を指定して GET call でスケジュール投稿のステータスを取得します。
Ayrshare ダッシュボードでステータスを確認します。まず投稿が公開された User Profile に切り替え、次に「Posts」ページに移動して Ayrshare Post ID を使用して検索します。

スケジュール投稿の一時停止

まだ公開されていないスケジュール投稿を一時停止できます。スケジュール投稿を一時停止すると、一時停止が解除されるまで投稿は公開されません。スケジュール投稿を一時停止または解除するには、PATCH call を使用します。投稿の一時停止が解除され、scheduleDate が過去である場合、投稿は即座に公開されることに注意してください。一時停止を解除する前に scheduleDate を更新することを検討してください。

リンクの短縮

投稿内のリンクは Ayrshare のリンクショートナーを使用して短縮できます。投稿を送信する際に shortenLinks パラメーターで自動リンク短縮をオンにできます。Max Pack が必要です。

{
  "post": "Hello, world with a link https://www.ayrshare.com",
  "platforms": ["linkedin"],
  "shortenLinks": true
}

Unsplash 画像

unsplash ボディパラメーターには以下のフィールドが利用可能です:

ランダム画像: random はランダムな Unsplash 画像を返します。
検索ベース画像: 値の文字列検索語 (例: money) は、money に基づいてランダムな画像を選択します。
画像 ID: 値の ID 配列 (例: [“HubtZZb2fCM”]) は画像 https://unsplash.com/photos/HubtZZb2fCM に対応します

{
  "post": "Hello, world!",
  "platforms": ["instagram"],
  "unsplash": "random",
  "unsplash": "search term", // unsplash: "money"
  "unsplash": ["unsplash image ID"] // unsplash: ["HubtZZb2fCM"]
}

Unsplash URL を mediaUrls にコピーして投稿する場合、URL だけでなく画像アドレスをコピーしてください。詳細については、この例を参照してください。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

承認ワークフロー

承認ワークフローの例

承認ワークフローの動画

自動ハッシュタグ

自動リポスト

First Comment

First Comment 処理時間

冪等な投稿

画像と動画の要件

画像と動画のガイドライン

有効な URL

自動メディア保護

スペースと特殊文字

ファイル名と URL のサニタイズ

追加情報

ダウンロード速度

動画の拡張子

画像または動画のみ

画像と動画のテスト

改行

マルチプラットフォーム投稿とメディア

Profile Key

Profiles

リッチテキスト投稿

HTML 要素

CSS コード

投稿のスケジューリング

スケジュール投稿の作成

スケジュール投稿のステータスを確認

スケジュール投稿の一時停止

リンクの短縮

Unsplash 画像

​承認ワークフロー

​承認ワークフローの例

​承認ワークフローの動画

​自動ハッシュタグ

​自動リポスト

​First Comment

​First Comment 処理時間

​冪等な投稿

​画像と動画の要件

画像と動画のガイドライン

​有効な URL

​自動メディア保護

​スペースと特殊文字

​ファイル名と URL のサニタイズ

​追加情報

​ダウンロード速度

​動画の拡張子

​画像または動画のみ

​画像と動画のテスト

​改行

​マルチプラットフォーム投稿とメディア

​Profile Key

Profiles

​リッチテキスト投稿

​HTML 要素

​CSS コード

​投稿のスケジューリング

​スケジュール投稿の作成

​スケジュール投稿のステータスを確認

​スケジュール投稿の一時停止

​リンクの短縮

​Unsplash 画像

承認ワークフロー

承認ワークフローの例

承認ワークフローの動画

自動ハッシュタグ

自動リポスト

First Comment

First Comment 処理時間

冪等な投稿

画像と動画の要件

有効な URL

自動メディア保護

スペースと特殊文字

ファイル名と URL のサニタイズ

追加情報

ダウンロード速度

動画の拡張子

画像または動画のみ

画像と動画のテスト

改行

マルチプラットフォーム投稿とメディア

Profile Key

リッチテキスト投稿

HTML 要素

CSS コード

投稿のスケジューリング

スケジュール投稿の作成

スケジュール投稿のステータスを確認

スケジュール投稿の一時停止

リンクの短縮

Unsplash 画像