メインコンテンツへスキップ
POST
あなたやあなたのユーザーが連携しているソーシャルネットワークに投稿を公開します。 User Profiles に投稿を公開したい場合は、詳細を /profiles endpoint でご覧ください。 Authorization ヘッダーAPI_KEY を、User Profile に投稿する場合は PROFILE_KEY も必ず追加してください。 API Key は Ayrshare Developer Dashboard の API Key ページで確認できます。 投稿オプションの詳細については Post API Overview をご覧ください。

ヘッダーパラメータ

ボディパラメータ

post
string
必須
platforms パラメータで指定したソーシャルネットワークに送信する投稿テキスト。 URL やリッチテキストの含め方など、高度なオプションはこちらをご覧ください。テキストなしで公開するには、空文字列 "" を送信できます。
platforms
array
必須
投稿するソーシャルメディアプラットフォーム。次のいずれかの値を持つ文字列の配列を受け付けます: blueskyfacebookgmbinstagramlinkedinpinterestredditsnapchattelegramthreadstiktoktwitter、または youtube注意: Facebook ページには facebook、Google Business Profile には gmb を使用してください。all を使用すると、連携されているすべてのソーシャルネットワークに投稿します。また、各ソーシャルネットワークで必須のフィールドを必ず含めてください。 例: youtube が連携されている場合、youTubeOptionstitle を含める必要があります。
mediaUrls
array
投稿に含める画像または動画 URL の配列。詳細は /media endpoint をご覧ください。URL はセキュアである必要があり、https:// で始まる必要があります。URL に特殊文字(例: ñ)が含まれる場合は、送信前に特殊文字をエンコードしてください。動画は有料プランが必要です。画像および動画の要件その他の高度なオプションはこちらをご覧ください。
isVideo
boolean
デフォルト:false
Ayrshare は URL のファイル拡張子(.mp4)に基づいてメディアタイプを判定しようとします。URL が既知の動画拡張子で終わらない場合(アニメーション GIF など)には、メディアが動画であることを明示的に設定できます。詳細は video extension をご覧ください。
scheduleDate
string
将来の投稿をスケジュールする日時。UTC 日時を受け付けます。例えば YYYY-MM-DDThh:mm:ssZ 形式を使用し、2026-07-08T12:30:00Z のように送信します。 追加の例は utctime をご覧ください。詳細は schedule posts もご覧ください。
validateScheduled
boolean
デフォルト:true
既定では、スケジュール済み投稿は受け入れ前にメディア要件などの問題について事前検証されます。 Ayrshare のチェックで問題が見つかると、即座にエラーレスポンスが返され、投稿はスケジュールされません。 スケジュール日時に到達すると投稿が公開され、その時点で最終的な成功またはエラーレスポンスが Webhook または /history endpoint 経由で送信されます。この事前検証ステップをスキップするには、validateScheduledfalse に設定します。エラーを早期に検出するため、スケジュール済み投稿では検証を有効のままにしておくことを推奨します。 そうしないと投稿がスケジュールされ、公開時にのみエラーを受け取ることになります。詳細は scheduled webhook actions をご覧ください。
firstComment
object
投稿後に自動的に最初のコメントを追加します。詳細は first comment をご覧ください。
disableComments
boolean
デフォルト:false
投稿のコメントを無効にします。Instagram、LinkedIn、TikTok でのみ利用可能です。
Ayrshare のリンク短縮機能 を使用して、すべてのプラットフォームで投稿内のリンクを短縮します。https で始まる URL のみが短縮されます。リンク短縮には Max Pack が必要です。サードパーティのリンク短縮サービス の使用については、こちらをご覧ください。
autoSchedule
object
詳細は auto-schedule をご覧ください。
autoRepost
object
一定の間隔でコンテンツを複数回自動的に再投稿し、常に新鮮で視認性の高いエバーグリーンなコンテンツを作成します。詳細は auto repost をご覧ください。
autoHashtag
object
詳細は auto hashtags をご覧ください。
unsplash
string
詳細は unsplash をご覧ください。
blueskyOptions
object
Bluesky details をご覧ください。
faceBookOptions
object
Facebook details をご覧ください。
gmbOptions
object
Google Business Profile details をご覧ください。
instagramOptions
object
Instagram details をご覧ください。
linkedInOptions
object
LinkedIn details をご覧ください。
pinterestOptions
object
Pinterest details をご覧ください。
redditOptions
object
Reddit details をご覧ください。
snapChatOptions
object
Snapchat details をご覧ください。
telegramOptions
object
Telegram details をご覧ください。
threadsOptions
object
Threads details をご覧ください。
tikTokOptions
object
TikTok details をご覧ください。
twitterOptions
object
X/Twitter details をご覧ください。
youTubeOptions
object
YouTube details をご覧ください。
requiresApproval
boolean
デフォルト:false
詳細は approval workflow をご覧ください。
randomPost
boolean
デフォルト:false
テスト用にランダムな投稿テキストを生成 します。randomPost: truepost フィールドを無視します。
randomMediaUrl
boolean
デフォルト:false
テスト用にランダムなメディア画像を生成 します。randomMediaUrl: truemediaUrls フィールドを無視します。
idempotencyKey
string
投稿に関連付けるオプションの一意 ID。重複した ID は拒否されます。詳細は idempotency をご覧ください。
notes
string
/history endpoint 経由で取得可能な投稿のメモを設定します。メモは参照専用であり、投稿には影響しません。