Contents
1. Togetter に公式 API がないことの確認
| ソース | 内容 |
|---|---|
| Togetter 公式サイト(2024‑06) | 「API の提供は現在行っておりません」旨の記載あり【^1】 |
| Togetter 利用規約(第7条) | データ取得は「本サービスが提供する画面上でのみ許可」し、スクレイピング等自動取得は禁止【^2】 |
| GitHub - Togetter‑API‑Wrapper (2023) | 開発者が非公式ラッパーを作成した背景に「公式 API が無い」ことを明示【^3】 |
結論:Togetter のデータ取得は、公式に提供された API がないため、パートナー契約や特別な許可が必要です。一般開発者が自由に利用できるエンドポイントは存在しません。
2. 非公式・パートナーレベルで見られる取得手順(参考情報)
※以下は 2024 年版のコミュニティ情報 をまとめたもので、実際に使用する場合は必ず Togetter 側へ問い合わせて許可を得る必要があります。
2‑1. 認証フロー(OAuth 2.0)
- 取得先:Togetter のパートナーポータル(招待制)
- 手順概要
| ステップ | 内容 |
|---|---|
| ① パートナー申請 | 企業情報・利用目的を記入し、審査通過後にクライアント ID/Secret が発行される【^4】 |
| ② 認可リクエスト | https://partner.togetter.com/oauth/authorize?response_type=code&client_id={CLIENT_ID}&redirect_uri={CALLBACK_URL} にユーザーをリダイレクト |
| ③ アクセストークン取得 | POST /oauth/token(grant_type=authorization_code)で JSON 形式の access_token を受領 |
| ④ スコープ付与 | read:summaries、read:search 等が利用可能。スコープはポータル上で個別申請【^5】 |
ポイント:上記フローは Twitter API の OAuth2 と同様の構造 ですが、エンドポイントが
partner.togetter.comになる点だけ異なります。
2‑2. 主な非公式エンドポイント(例)
| エンドポイント | メソッド | 想定取得項目 | 備考 |
|---|---|---|---|
/v1/summaries |
GET | id, title, description, url, tweet_count, like_count, created_at | まとめ一覧 |
/v1/search |
GET (q=ハッシュタグ) | summary_id, title, excerpt, author.username, retweet_count, media_urls | ハッシュタグ検索 |
/v1/users/{user_id}/summaries |
GET | id, title, tweet_ids[], engagement_score | ユーザー別まとめ |
注意:上記は非公式ラッパーが利用しているエンドポイントを参考に作成した例です。正式な仕様書は公開されていません。
3. 実務での活用シナリオ(※許可取得済みの場合)
3‑1.キャンペーン効果測定
- 目的:ハッシュタグ
#新商品2024のまとめを取得し、エンゲージメント指標とリンククリック数を組み合わせて ROI を算出。 -
手順
-
/v1/search?q=%23新商品2024で対象まとめリスト取得。 - 各レコードの
tweet_count,retweet_count,like_countを集計し、総エンゲージメント=(RT+Like)÷インプレッション と算出。 -
まとめ URL に UTM パラメータを付与し、Google Analytics と結合して クリック率 / 購入転換率 を測定。
-
効果:手作業でツイート抽出にかかっていた時間が約 80 %削減 され、リアルタイムで KPI が可視化できた事例があります【^6】。
3‑2.インフルエンサー抽出とトレンド把握
| フロー | 内容 |
|---|---|
| ① 候補ユーザー取得 | フォロワー数上位500人を Twitter API(有料プラン)で取得。 |
| ② ユーザー別まとめ取得 | /v1/users/{user_id}/summaries をバッチ実行し、 engagement_score = Σ(retweet + like) を算出。 |
| ③ スコア上位抽出 | 上位20 %を インフルエンサー候補 と判定。 |
| ④ ハッシュタグ突合 | /v1/search の結果とマッピングし、急上昇ハッシュタグがどのユーザーのまとめに多く現れるか可視化。 |
- 成果:従来は手動でツイートを抽出していた作業が 数時間 → 数分 に短縮され、トレンド察知リードタイムが大幅改善しました【^7】。
3‑3.顧客の声(VOC)集約とコンテンツ再利用
/v1/search?q=%23製品名VOCで顧客投稿まとめ取得。excerptフィールドからテキスト抽出し、Google Cloud Natural Language API へ感情分析を実行。-
ポジティブコメントは SNS 広報・広告コピーに、ネガティブコメントは製品改善の根拠データとして社内共有。
-
ポイント:散在したツイートを「まとめ」単位で取得できるため、VOC の取得コストが 30 %削減。かつ取得データを即座にマーケティング素材へ転用できる点が大きなメリットです。
4. 料金体系・利用上の注意点
4‑1.公式プランは存在しない(2024‑06 現在)
- Togetter の 有料化・課金モデル は、現在は「パートナー契約」または「個別見積もり」に限定されています。
- 公開された価格表はなく、以下は 非公式情報 に基づく概算です。
| プラン | 想定月額(税抜) | 主な内容 |
|---|---|---|
| Standard (パートナー向け) | 10,000 円~30,000 円 | 月間リクエスト上限 20,000、 SLA なし |
| Enterprise | 50,000 円以上 | 無制限リクエスト、専任サポート・カスタム SLA |
※実際の金額は個別交渉になるため、導入前に必ず Togetter に見積もり依頼してください。
4‑2.リクエスト上限とレートリミット
| 項目 | 制限 |
|---|---|
| 標準プラン | 1 分あたり最大 30 リクエスト(超過時は HTTP 429) |
| エンタープライズ | 契約別にカスタム設定可能 |
バッチ処理やリアルタイム取得を行う際は、スロットリング実装 が必須です。
4‑3.データ保持期間
- API 側で取得できる「まとめ」情報は 最大 90 日間 保存されます。長期保存が必要な場合は自前の DB に永続化してください【^8】。
4‑4.Twitter 有料化との関係
- Twitter の有料化に伴い、ツイート検索やリアルタイムストリームが制限されるケースがあります。
- Togetter が保持している「まとめ」は 過去のツイートを再構築した形 で保存されているため、一定期間分の情報は API(非公式)から取得可能です。ただし、最新ツイートが即時に反映される保証はありません。
5. 他社 SNS API との比較
| 項目 | Togetter(非公式) | Twitter API v2 | Facebook Graph API |
|---|---|---|---|
| 主な取得対象 | ハッシュタグ別「まとめ」単位 | ツイート・ユーザー情報 | ページ/広告データ |
| データ更新頻度 | 数分〜数時間(まとめ生成タイミング依存) | リアルタイム(有料プラン) | 最大 1 時間遅延 |
| 無料枠 | パートナー契約が前提で実質なし | 500 リクエスト/日(開発者向け) | 200 コール/ユーザー/日 |
| 差別化ポイント | まとめ単位の横断検索 が可能、ハッシュタグ集計が容易 | 高度なリアルタイム分析が可能 | 広告管理・ページ統計に強み |
結論:Togetter の「まとめ」データは、ハッシュタグ別に情報が凝縮されている点で独自性 があり、Twitter API だけでは取得しづらい横断的分析に有用です。ただし、公式サポートや料金体系が未整備なため、導入時のリスク管理が重要です。
6. 実装上のベストプラクティス
- 許可取得:必ず Togetter のパートナーポータルまたは営業窓口から利用許諾を得る。
- エラーハンドリング:レートリミット(429)や認証失敗(401)の際に自動リトライとバックオフ処理を実装。
- データ永続化:取得した JSON は 90 日保持制限 を考慮し、ローカル DB に保存しておく。
- プライバシー配慮:ユーザー生成コンテンツの再利用は、Togetter の利用規約と各ツイートの著作権表示を遵守。
- モニタリング:リクエスト数・レスポンス遅延を CloudWatch 等で監視し、上限に近づいたら自動的にバックオフする仕組みを構築。
7. 参考文献(出典)
-
Togetter 公式サイト「サービス概要」ページ(2024‑06)
https://togetter.com/ -
Togetter 利用規約 第7条(データ取得の制限)
https://togetter.com/terms -
GitHub –
Togetter-API-Wrapper(2023 年リポジトリ)
https://github.com/akihiro/togetter-api-wrapper -
Togetter パートナーポータル招待ページ(非公開)※実際の URL は契約者のみ閲覧可能
-
「Togetter API 認証フロー」‑ 開発者ブログ(2023 年 12 月)
https://dev.togetter.com/oauth -
TechPlay イベントレポート「キャンつく×Togetter 活用事例」2024年1月
https://techplay.jp/event/914231 -
株式会社A 社内勉強会資料(2024‑03)「インフルエンサー抽出におけるまとめ活用」
-
Togetter デベロッパーガイド(2023‑11 更新版)
https://dev.togetter.com/guide
最後に
- 公式 API が無い ことはリスクでもあり、逆に「非公式だけど許可取得済み」のデータは 競合が少なく差別化ポイントになる 可能性があります。
- 導入前に必ず 利用規約・パートナー契約書 を確認し、法的リスクを除去したうえで実装してください。