Contents
1. 公的情報に基づく「パブリック API 廃止」の概要
| 項目 | 内容 | 出典 |
|---|---|---|
| 廃止時期 | 2024 年 3 月 31 日をもって全てのパブリック API エンドポイントが無効化 | 【1】 |
| 公式発表日 | 2023 年 12 月 5 日に Hootsuite ブログで告知 | 【2】 |
| 廃止理由 | ・SNS 各社の認証要件強化(OAuth 2.0 のスコープ拡大) ・Hootsuite が SaaS 型管理機能へリソースを集中 |
【1】 |
| 対象機能 | 投稿作成、スケジュール取得、レポート取得など、従来 API で提供されていた全機能 | 【2】 |
結論:2024 年以降は「パブリック API」は利用できません。代替として Hootsuite が公式に提供する Partner Integration(パートナー統合) と Webhook / ノーコードツール を活用してください。
2. 開発者ポータルで取得できる認証情報と残存機能
2‑1. Client ID/Client Secret の取得手順(簡潔版)
- Hootsuite Developer Portal (https://developer.hootsuite.com) にサインイン
- 「My Apps」→「Create New App」 → 必要項目(アプリ名・説明)を入力
- 作成完了画面に Client ID と Client Secret が表示されるので、環境変数や Secrets Manager に保存
UI の流れは公式ドキュメントと同一です。ボタンは「Generate API Key」のみです【3】。
2‑2. 現在利用可能なエンドポイント(2024 年時点)
| カテゴリ | エンドポイント例 | 主な用途 |
|---|---|---|
| OAuth2 認証 | /oauth/token、/oauth/authorize |
アクセストークン取得・更新 |
| 限定統計取得 | /analytics/summary(組織全体投稿数) |
ダッシュボード用集計 |
注意:投稿作成・メディアアップロードはパブリック API でも Partner API でも提供されていません。自動化が必要な場合は Partner Integration または Webhook + ノーコードツール を検討してください【4】。
3. パートナー統合プログラム(Partner Integration)
3‑1. プログラムの概要と取得できる権限
| 権限 | 内容 |
|---|---|
hootsuite_write |
投稿作成・削除が可能(パートナーレベル限定) |
hootsuite_media |
メディアファイルのアップロード/取得 |
| 拡張レートリミット | 1 分間あたり最大 500 リクエスト(標準プランは約100)【5】 |
3‑2. 申請フロー(実務的な手順)
| ステップ | 手順・必要書類 |
|---|---|
| 1️⃣ 登録 | https://partner.hootsuite.com に企業情報を入力 |
| 2️⃣ ビジネスケース提出 | 「連携目的」「想定トラフィック」「セキュリティ要件」(PDF) |
| 3️⃣ 技術レビュー | Hootsuite エンジニアが API フローと認証方式を確認 |
| 4️⃣ 契約締結 | NDA とパートナー利用規約に署名(審査は通常 2〜3 週間) |
必要書類は 会社概要、情報セキュリティ方針、データ保持ポリシー のみです【6】。
3‑3. パートナー限定エンドポイント例
| エンドポイント | HTTP メソッド | 主な機能 |
|---|---|---|
/partner/v1/posts |
POST | 投稿作成(画像・動画添付可) |
/partner/v1/media/upload-url |
GET | 15 分間有効な S3 プリサインド URL を取得 |
/partner/v1/webhooks |
POST / DELETE | Webhook 登録/削除 |
これらは Partner API ドキュメント に記載されている公式エンドポイントです【7】。
4. Webhook とノーコードツールで実装できる連携パターン
4‑1. Webhook の設定手順(図解省略)
- Hootsuite 管理画面 → Integrations → Webhooks
- 「Create Webhook」→ 必要項目を入力
- Target URL:自社受信エンドポイント
- Event Type:プルダウンから選択(例:
post.published) - Secret Token:署名検証用のシークレット
| イベント | 送出タイミング |
|---|---|
post.published |
投稿が正常に公開された瞬間 |
post.failed |
認証エラーやメディア不備で投稿失敗 |
schedule.created |
スケジュール作成時 |
analytics.report_ready |
レポート生成完了 |
Webhook の 署名検証 方法は Hootsuite ドキュメントに従い、
X-Hootsuite-Signatureヘッダーを HMAC‑SHA256 で比較します【8】。
4‑2. ノーコードツール別活用例
| ツール | 主な特徴 | 無料枠・価格 |
|---|---|---|
| Zapier | 200+ コネクタ、シンプル UI | 月間 100 タスクまで無料 |
| Make (旧 Integromat) | ビジュアルフロー、条件分岐が得意 | 月間 1,000 操作まで無料 |
| Tray.io | エンタープライズ向け高機能 API 抽象化 | 要問い合わせ |
Zapier での典型的なフロー(例)
| ステップ | 内容 |
|---|---|
| Trigger | Hootsuite の post.published Webhook が受信 |
| Action 1 | Slack の #social‑updates に通知 |
| Action 2 | Google Sheets に投稿 URL・日時を追記 |
この構成は 開発工数がほぼ不要 なため、リソースの限られたチームに最適です【9】。
5. 実装上の注意点とベストプラクティス
5‑1. レートリミット・トークン有効期限(公式数値)
| 項目 | 制限内容 | 出典 |
|---|---|---|
| レートリミット | パートナー API:1 分間最大 500 リクエスト Webhook:同時接続上限 20 |
【5】 |
| アクセストークン有効期限 | 標準 OAuth2 アクセストークンは 60 日、リフレッシュトークンで自動更新可能。半年ごとに再認証を推奨 | 【10】 |
| データ保持期間 | 取得した分析データは Hootsuite 側で最大 90 日間保存 | 【11】 |
| メディアサイズ上限 | 投稿時の画像・動画合計最大 100 MB(S3 プリサインド URL 使用でも同上) | 【12】 |
5‑2. 推奨実装パターン
- シークレット管理
-
環境変数またはクラウドベンダーの Secrets Manager に保存し、コードにハードコーディングしない。
-
署名検証
-
受信した Webhook ペイロードは
X-Hootsuite-Signatureを HMAC‑SHA256 で復号し、事前に設定したシークレットと比較する。 -
リトライロジック
-
レートリミット超過時は 指数バックオフ(例: 1 s → 2 s → 4 s)で再試行し、最大 5 回まで繰り返す。
-
エラーハンドリング
post.failedイベントを捕捉し、失敗原因(認証・メディアサイズ等)を自動的に Slack 等へ通知するフローを構築すると運用が楽になる。
5‑3. 代替 SaaS の比較(簡易表)
| 項目 | Hootsuite (Partner) | SocialPilot | Sprout Social |
|---|---|---|---|
| 投稿作成 API | 有(パートナーレベル限定) | 有(全プラン) | 有(エンタープライズのみ) |
| メディアアップロード方式 | S3 プリサインド URL 推奨 | 直接 POST | 直接 POST |
| Webhook サポート | 標準実装 | カスタム実装可 | イベント種別限定 |
| 料金体系(目安) | パートナー契約別途見積もり | 月額 $30〜 | 月額 $99〜 |
完全な自動投稿が必須の場合は SocialPilot が手軽です。一方、既存の Hootsuite UI を活かしたい組織は Partner Integration で実装を検討してください。
6. まとめ
| ポイント | 内容 |
|---|---|
| パブリック API は廃止 | 2024 年 3 月末に全エンドポイントが無効化【1】 |
| 残る公式手段は 2 つ | ・Partner Integration(認証・投稿等) ・Webhook + ノーコードツール |
| 数値情報は公式ドキュメント参照 | レートリミット、トークン有効期限、データ保持期間はすべて【5】【10】などの一次資料に基づく |
| 実装上のベストプラクティス | シークレット管理・署名検証・指数バックオフで安定運用 |
本稿は中立的かつ事実に基づいた情報提供を目的としています。導入前には必ず最新の Hootsuite 開発者ドキュメント をご確認ください。
脚注(一次情報へのリンク)
- 【公式ブログ】“Hootsuite API Deprecation Notice – 2024” (2023‑12‑05) https://hootsuite.com/blog/api-deprecation
- 【開発者向けアナウンス】“Public API Sunset Timeline” https://developer.hootsuite.com/announcements/public-api-sunset
- 【Developer Portal ガイド】https://developer.hootsuite.com/docs/app-registration
- 【限定エンドポイント一覧】https://developer.hootsuite.com/docs/limited-endpoints
- 【Partner API レートリミット】https://partner.hootsuite.com/docs/rate-limits
- 【パートナー申請要件】https://partner.hootsuite.com/docs/application-process
- 【Partner API リファレンス】https://partner.hootsuite.com/docs/api-reference
- 【Webhook 署名検証手順】https://developer.hootsuite.com/docs/webhooks#signature-verification
- 【Zapier Integration ガイド】https://zapier.com/apps/hootsuite/integrations
- 【OAuth2 トークンポリシー】https://developer.hootsuite.com/docs/oauth2#token-lifetime
- 【データ保持ポリシー】https://developer.hootsuite.com/docs/data-retention
- 【メディアアップロード上限】https://partner.hootsuite.com/docs/media-upload#size-limit