メインコンテンツへスキップ
APIに対する以下の変更は、指定された日付から有効になります。 互換性を破る可能性のある変更については慎重にご確認ください。 すべての新機能については、What’s Newをご覧ください。
June 15, 2026
  • Facebook: Metaがユニークインプレッション(リーチ)および3秒動画視聴のInsights指標を廃止しました。 MetaはすべてのGraph APIバージョンでこれらの指標を削除したため、影響を受けるフィールドは返却されなくなりました。詳細については、Meta Graph API v25 changelogをご覧ください。
    • GET analytics/postは、以下のFacebookフィールドを返却しなくなりました:
      • impressionsUnique → mediaViewに移行
      • impressionsFanUnique → mediaViewに移行
      • impressionsOrganicUnique → mediaViewに移行
      • impressionsPaidUnique → mediaViewIsFromAdsに移行
      • videoViewsUnique → 非ユニーク3秒視聴にはvideoViewsを使用
      • totalVideoViews*UniqueおよびtotalVideoImpressions*ファミリー(例: totalVideoViewsOrganicUniquetotalVideoViewsPaidUniquetotalVideoViewsUnique)
    • GET analytics/socialは、以下のFacebookフィールドを返却しなくなりました:
      • pagePostsImpressions*ファミリー(pagePostsImpressionspagePostsImpressionsPaidpagePostsImpressionsUniquepagePostsImpressionsOrganicUniquepagePostsImpressionsViral*pagePostsImpressionsNonviral*) → pageMediaViewに移行
      • pagePostsServedImpressionsOrganicUnique → pageMediaViewに移行
      • pageVideoViewsUnique → 非ユニーク3秒視聴にはpageVideoViewsを使用
    • リーチにはmediaView / pageMediaViewを使用してください。Total Unique Media Viewsの後継指標が計画されています。reactionsByTypevideoViewsmediaViewpagePostEngagementspageVideoViewspageVideoViewsPaidなど、引き続きサポートされるフィールドは影響を受けません。
May 11, 2026
  • YouTubeの一時的な障害はHTTP 500ではなくHTTP 503/504を返すようになりました: これまでHTTP 500(code: 176)として現れていた一部のYouTubeアップロード失敗は、HTTP 503(code: 454)またはHTTP 504(code: 453)を返すようになりました。両レスポンスにはretryAvailable: trueが含まれます。HTTP 500でフィルタしてYouTubeアップロードをリトライしていた顧客の統合は、レスポンスボディのretryAvailableフィールドでフィルタする方式に切り替えてください。詳細については、エラーコードをご覧ください。
April 9, 2026
  • 空の分析でエラー187を返します: プラットフォームからデータが返されない場合、ソーシャル分析または投稿分析をリクエストすると、以前の{ "status": "success" }ではなく{ "status": "error", "code": 187 }が返されるようになりました。以前の空成功動作に依存しているクライアントコードは更新してください。
March 31, 2026
  • X/Twitter BYOキー要件: Ayrshare経由のX/Twitter操作すべてで、独自のAPI認証情報が必要になります。OAuth経由でXアカウントを連携した後、すべてのX/TwitterリクエストにX-Twitter-OAuth1-Api-KeyX-Twitter-OAuth1-Api-Secretの2つのヘッダーを含めてください。有効な認証情報のないリクエストは拒否されます。手順については、X BYOキー設定ガイドをご覧ください。
  • RSS-to-Xは非推奨になります: RSS自動投稿のX/Twitterサポートは2026年3月31日以降廃止されます。RSSフィードはリクエストごとの認証情報なしでスケジュール実行されるため、BYOキーモデルと互換性がありません。他のプラットフォームへのRSS自動投稿は影響を受けません。
  • X Account Activity Webhookは非推奨になります: X Account Activity webhookアクション(accountActivity)は2026年3月31日以降利用できなくなります。これには、連携されたXアカウントに対するすべてのリアルタイムイベント通知(投稿、メンション、DM、いいね、フォロー、ブロックなど)が含まれます。
November 14, 2025
  • 2025年11月14日より、FacebookはGET analytics/socialで以下のフィールドを非推奨にします:
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → pageMediaViewに移行
    • pageImpressionsPaidUnique → pageMediaViewIsFromAdsに移行
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → pageMediaViewIsFromAdsに移行
  • 2025年11月14日より、FacebookはGET analytics/postで以下のフィールドを非推奨にします:
    • impressionsおよびimpressionsFanPaidUnique → mediaViewに移行。細分化された内訳はmediaViewIsFromAds(広告帰属視聴)とmediaViewIsFromFollowers(フォロワー帰属視聴)で利用可能。
    • postImpressionsUnique(Reels) → リール再生回数にはblueReelsPlayCountを、視聴時間の合計にはpostVideoViewTimeを使用してください。
September 1, 2025
  • 2025年9月1日より、Instagramのコメント取得エンドポイントは返信オブジェクトのtextフィールドを含まなくなります。返信内容にアクセスするには、代わりにcommentフィールドを使用してください。
June 1, 2025
  • X (Twitter)のコメント取得エンドポイントは、ユーザーの公開指標を新しいpublicMetricsオブジェクトに移動します。以下のフィールドはトップレベルからpublicMetricsオブジェクトに移動されます:
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • FacebookはGET analytics/socialで以下のフィールドを非推奨にします:
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
May 7, 2025
  • YouTubeは、許可およびブロックされた地域の設定を非推奨にしました。postエンドポイントに引き続き許可およびブロック地域を追加できますが、無視されます。
April 20, 2025
  • Instagram投稿分析の以下の指標は非推奨になります:REELS:
    • playsCount
    • clipsReplaysCount
    • igReelsAggregatedAllPlaysCount
    FEED/STORY:
    • impressionsCount
  • historyエンドポイントは、limitがデフォルトの25より大きい場合、1分間のキャッシュを強制します。
March 1, 2025
TikTokのコメント取得エンドポイントは、他のソーシャルネットワークに合わせてフィールド名を標準化します。
  • replyListフィールドはrepliesに、profileImageprofileImageUrlに名前が変更されます。
  • 両方の新しいフィールド名はすでに利用可能で、統合で使用できます。
  • TikTokには以下の更新があります:
    • ソーシャル分析エンドポイント: 以下の変更が予定されています: • durationAverageフィールドは非推奨となり削除されます。• TikTok APIの制限により、shareCountTotalviewCountTotalcommentCountTotalフィールドは、全期間の合計ではなく過去60日間の合計のみを返すようになります。• 60日間の合計を今すぐ使用するには、APIリクエストボディにperiod60Days: trueを追加してください。注意: このパラメータを使用すると、レスポンス時間が大幅に改善されます。
    • 履歴プラットフォームおよび投稿分析エンドポイント: 未文書化のフィールドcaptioncommentsshareslikesshareUrlitemsIdは削除されます。代わりにpostcommentsCountsharesCountlikesCountpostUrlidフィールドを使用してください。
February 1, 2025
/userエンドポイントはAPI使用量の報告方法を変更します:
  • monthlyApiCallsフィールドは、すべてのAPI呼び出し(投稿、コメント、分析など)をカウントするように拡張されます。
  • 投稿固有のカウントには、新しいmonthlyPostCountフィールドを使用してください。
  • monthlyApiCallsQuotaフィールドは非推奨となり、新しいmonthlyPostQuotaフィールドに置き換えられます。
January 5, 2025
  • MetaはInstagramの投稿分析エンドポイントにおけるvideoViewsフィールドを非推奨にします。
  • さらに、Instagramのソーシャル分析エンドポイントから、emailContactsCountgetDirectionClicksprofileViewsCounttextMessageClickswebsiteClicksCount、およびphoneCallClicksCountフィールドが削除されます。
  • これらのフィールドは2025年1月5日に削除されます。
December 15, 2024
  • セキュリティ強化のため、Profile KeyがAPI Keyとして使用されないようにします。API Keyの代わりにProfile Keyを使用しようとすると、システムがエラーを返します。Profile Keyの正しい使用方法については、こちらをご覧ください。
November 15, 2024
  • TikTokスケジュール済みwebhookのエラー報告方法を更新しました。これらのエラーは、他のスケジュール済みwebhookタイプのエラー処理と同様、errors配列に表示されるようになりました。なお、現在のトップレベルエラーは引き続き返されますが、errors配列の使用を推奨します。
  • historyエンドポイントは、デフォルトでレスポンスをオブジェクトとして返すようになりました。objResponseパラメータは自動的にtrueに設定されます。
  • Get All History LinkedInは、mediaUrlsオブジェクトを配列として返します。以前は、メディア項目が1つだけの場合はオブジェクトを、複数のメディア項目の場合は配列を返していました。現在は、メディア項目が1つだけの場合でも常に配列が返されます。以前の動作が必要な場合は、objResponse: falseクエリパラメータを使用できます。
October 7, 2024
  • mediaエンドポイントはurl_1080を返さなくなります。画像のリサイズが必要な場合は、resizeエンドポイントをご覧ください。
September 16, 2024
June 3, 2024
  • 新しいリンク短縮システムが、Googleによって非推奨とされた短縮エンドポイントを置き換えます。新しいリンク短縮ツールには、アドオンのMax Packが必要です。
  • リンク短縮はデフォルトでオフ(false)になります。リンクを自動的に短縮するには、postエンドポイント呼び出しでshortenLinks: trueを使用してください。これは新しいlinkエンドポイントを使用します。
April 22, 2024
  • MetaはFacebook Groups APIを非推奨にします。お知らせをご覧ください。
April 16, 2024
  • Instagramは、オンラインフォロワーデータセットの期間を明確化しました。詳細については、こちらをご覧ください。
April 1, 2024
  • コメントIDを使用したコメントへの返信のデフォルトレスポンスは、配列ではなくドキュメントに記載されているオブジェクトになります。配列レスポンスを維持したい場合は、objResponseパラメータをboolean falseに設定できます。
January 25, 2024
December 8, 2023
  • /history/instagramエンドポイントのcaptionmessagecreatedTimetimestampフィールドは2023年4月1日に非推奨となり、削除されます。postおよびcreatedフィールドを使用してください。
  • /history/linkedinエンドポイントのmediaUrlsフィールドは、複数の画像をサポートするため、オブジェクトではなく配列として返されます。LinkedInクエリパラメータ?multiMedia=trueを含めることで、現在も配列を返すよう強制できます。なお、2023年12月1日より前は、複数の画像を含むメディアを返すにはmultiMediaクエリパラメータを使用する必要があります。2023年12月1日以降は、デフォルトで複数の画像が返されるようになります。
  • Scheduled Action TikTok webhookは、文字列型のplatformが非推奨になります。他のScheduled Action webhookと同様に、platforms配列フィールドを使用してください。
  • delete commentドキュメントは、正しい返り値に合わせて修正されました。
  • TikTokのcommentIdフィールドは、標準のコメント削除形式に合わせるため、idフィールドに置き換えられます。
  • Twitterのdelete commentの返り値は、posts配列を含まなくなり、標準のコメント削除形式に沿った返り値になります。新しい返り値は次のとおりです:
October 18, 2023
May 30, 2023
  • Twitterの新しいAPIバージョン2にアップグレードしました。Twitterはバージョン2でいくつかのフィールドを非推奨にしました。これは/analytics/socialおよびgetAllHistoryエンドポイントに影響します。これらのフィールドは2023年9月1日まで引き続き返されますが、ゼロまたは空文字列の値になります。
May 8, 2023
  • TikTokの直接公開、コメント管理、および高度な分析をリリースいたします。ユーザーは、投稿してキャプションテキストを入力するためにTikTokモバイルアプリを開く必要がなくなります。Ayrshare経由で送信した後、TikTok動画とキャプションが直接公開されます。
  • TikTokコメントの追加、取得、削除、およびデモグラフィック分析データも導入します。
  • 直接公開を有効にするには、ユーザーはTikTokアカウントの連携を解除し、再連携する必要があります。既存の接続は、間接的な方法で継続し、公開にはTikTokモバイルアプリが必要です。
February 17, 2023
  • Google Business Profileは、利用可能なソーシャル分析データを変更しました。新しい利用可能なフィールドは以下のとおりです。以前のフィールドは引き続き存在しますが、値はゼロとなり、2023年3月17日に完全に削除されます。
October 1, 2022
  • Get All Postsのdescriptions、text、messageフィールドはpostフィールドに標準化されました。
September 12, 2022
  • TikTokフィールドが非推奨: shareUrl。代わりにpostUrlを使用してください。
June 17, 2022
  • すべてのhistoryエンドポイントで、createdAtcreatedTimetimestampフィールドは、UTC形式で作成時刻を返すcreatedフィールドに置き換えられます。
  • scheduleDateフィールドは、UTC形式でスケジュール時刻を含む文字列によってオブジェクトを返さなくなります。
  • /historyの未文書化created_dateフィールドは削除されます。代わりにcreatedを使用してください。
April 22, 2022
  • Facebook投稿の分析は、reactionsを以下の形式のオブジェクトとして返します。
April 1, 2022
  • historyはデフォルトで最新20件の投稿を返します。lastRecordsパラメータで最大500件を返却できます。