Contents
Togetter API とは？
Togetter API は、ツイッターの投稿を収集してまとめることができるサービス「Togetter（トゲッター）」が提供するAPIです。このAPIを使うと、特定のキーワードやユーザーに関連したツイートをプログラムで取得できるようになります。Webサービス開発者であれば、リアルタイムな情報収集やデータ分析に活用できます。
Togetter API の主な特徴は、「ツイートの検索・取得機能」です。例えば「#AI技術」というハッシュタグを含むツイートを自動で抽出したり、特定ユーザーの投稿履歴を一括して取得することが可能です。プログラミング知識があれば、誰でも簡単にAPIとのやり取りができます。
API キーの取得方法
Togetter API を使用するには、まず API キー（アクセストークン）が必要です。このセクションでは、公式サイトでAPIキーを取得する手順をステップバイステップで説明します。
アカウント登録が必要な場合
- Togetterの公式サイトにアクセスし、「新規登録」ボタンをクリックします。
- メールアドレスとパスワードを入力してアカウントを作成します。
- 登録後、マイページから「API キーの発行」オプションを選択し、個人情報を確認して申請します。
注意: 公式サイトでは利用規約と個人情報保護方針を必ず確認してください。
API キーの確認手順
- 申請が承認されると、マイページ内の「API キー一覧」に生成されたトークンが表示されます。
- プログラムで使用する際には、このキーをリクエストヘッダに含めることで認証が完了します。
エンドポイントの呼び出し方法
Togetter API はRESTfulなAPIであり、HTTPメソッド（GETやPOST）を使ってデータ取得を行います。ここでは具体的な例を用いて、実際の呼び出しイメージをお伝えします。
GET メソッドの基本
Togetter API でよく使われる GET メソッドは、URLにパラメータを付けて情報を取得する方法です。以下の例を見てください：
|
1 2 |
https://api.togetter.com/v1/search?query=AI技術&count=5 |
このURLでは、「AI技術」というキーワードに関連するツイートの上位5件を取得します。
パラメータの使い方
Togetter API は、以下のパラメータを使って検索条件を指定できます：
| パラメータ名 | 説明 | 例 |
|---|---|---|
query |
検索キーワード | AI技術 |
count |
取得件数（最大100件） | 5 |
since_id |
最新のツイートIDから取得 | 1234567890 |
パラメータはURLに直接追加するため、複数指定する場合は「&」で区切ります。
認証プロセスの詳細
Togetter API では、API キー（アクセストークン）を使ってリクエストを認証します。ここでは、認証が必要な理由と基本的な手順を説明します。
API キーの有効期限について
To getter API のAPIキーには有効期限がありませんが、セキュリティ上定期的に再発行することをお勧めします。以下のケースでは、APIキーを再発行してください：
- アカウントロックが発生した場合
- 長期間使わない予定がある場合
認証失敗時のエラーメッセージの見方
認証に失敗すると、HTTPステータスコード 401 Unauthorized が返されます。この際、以下のチェックをしましょう：
- APIキーの入力ミスがないか確認する
- リクエストヘッダに
Authorization: Bearer {API_KEY}が正しく含まれているか確認する
ヒント: エラーメッセージが表示されない場合は、リクエストの送信タイミングやネットワーク接続を再確認してください。
JSON レスポンスの処理基礎
To getter API から返されるデータはJSON形式で、プログラミング言語によって解析できます。ここでは具体的なデータ構造と処理方法を解説します。
データ構造の確認方法
以下が実際のレスポンス例です：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
{ "data": [ { "id": "1234567890", "text": "AI技術は日々進化しています。", "user": { "name": "TechUser", "screen_name": "@tech_user" } } ] } |
このJSONでは、data配列内に取得したツイートが格納されています。
id: ツイートの識別子（ユニーク）text: ツイート本文user.name: 投稿者の名前
エラー時の対処法
エラーが発生した際のJSON応答例：
|
1 2 3 4 5 6 7 |
{ "error": { "code": "401", "message": "認証に失敗しました。APIキーを確認してください。" } } |
この場合、error.messageに記載された内容を確認して対応しましょう。
簡単な実装サンプルコード
ここでは、初心者でも理解できるPythonとJavaScriptの例を紹介します。
Python での実装例
Pythonには requests ライブラリを使用します：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
import requests url = "https://api.togetter.com/v1/search" params = { "query": "AI技術", "count": 5 } headers = { "Authorization": "Bearer YOUR_API_KEY" } response = requests.get(url, params=params, headers=headers) data = response.json() for tweet in data["data"]: print(f"投稿者: {tweet['user']['name']}") print(f"本文: {tweet['text']}\n") |
注意: YOUR_API_KEY を実際のAPIキーに置き換えてください。
JavaScript での実装例
JavaScriptには fetch API を利用します：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
const url = "https://api.togetter.com/v1/search"; const params = new URLSearchParams({ query: "AI技術", count: 5 }); fetch(`${url}?${params}`, { method: "GET", headers: { "Authorization": "Bearer YOUR_API_KEY" } }) .then(response => response.json()) .then(data => { data.data.forEach(tweet => { console.log(`投稿者: ${tweet.user.name}`); console.log(`本文: ${tweet.text}\n`); }); }); |
注意: YOUR_API_KEY を実際のAPIキーに置き換えてください。
まとめ
本記事では、To getter API の基本的な利用方法についてステップバイステップで解説しました。以下が主なポイントです：
- API キーの取得: 公式サイトでアカウント登録・発行が必要です
- エンドポイント呼び出し: GETメソッドを使ってパラメータを指定します
- 認証プロセス: リクエストヘッダにAPIキーを含めることで完了します
- JSON 処理: 投稿内容や投稿者情報を解析することが可能です
- 実装サンプル: PythonとJavaScriptを使ったコードが参考になります
To getter API は、ツイートデータをプログラムで取得するうえで非常に有用なツールです。初心者でも実装可能なため、ぜひ実際に使ってみてください！