Twitter APIの使用方法

Data365のTwitter APIは、Twitterから多くの公開データを取得するための信頼できるツールです。キーワードやフレーズを使用してツイートやプロフィールを検索できます。私たちのTwitter APIを使用することで、消費者の嗜好を分析し、ソーシャルメディアのトレンドを浮き彫りにするために欠かせない信頼性の高いデータの配列を受け取ることができます。したがって、マーケティングリサーチや分析に従事する企業にとって、Twitter APIの利用はしばしば必須です。なぜなら、Twitter上で毎日生成される膨大なコンテンツからのモニタリングとデータ抽出を提供するからです。

この記事では、Twitter APIの使用方法を詳しく見ていきます。Twitter APIとは何かを説明し、POSTおよびGETリクエストの動作、さらにTwitterのcallback_urlパラメータについて解説します。Data365のTwitter APIのレスポンス形式と取得できるデータについてもお話しします。また、ツイート検索の例を用いて、私たちのTwitter APIの使用方法を示します。最後に、Data365.coによるTwitter APIのテスト方法についての情報も少しご紹介します。

Twitter APIのクエリ

Data365のTwitter APIはHTTPに基づいているため、受信者自身がサーバーにクエリを開始し、POSTおよびGETメソッドを使用して大量のデータを受信します。

POSTリクエストはデータを更新するタスクであり、つまり新しいTwitterデータをData365データベースに追加するか、既存のデータを更新するタスクです。POSTリクエストには料金が発生し、メンション数でカウントされます。たとえば、1つのツイートのデータをリクエストするコストは1メンション、プロフィールの場合は9メンション、ツイートやプロフィールを検索する場合は7メンションです。

GETリクエストは、POSTクエリが完了した後に収集されたデータを取得するためにData365データベースに対して行うクエリです。1秒間に最大100のGETリクエストを送信できます。GETリクエストには料金が発生しません。

Twitter APIへのリクエストの作成方法

データを抽出するためのTwitter APIリクエストを作成する際には、要素ID、つまりツイートIDまたはプロフィールIDを指定する必要があります。検索クエリ（ツイートやプロフィールの検索）を作成する際には、キーワード、フレーズ、またはハッシュタグを使用できます。

検索パラメータnearを使用すると、位置情報でツイートやプロフィールを検索したり、結果を位置情報でフィルタリングしたりできます。これはTwitter検索リクエストのnearパラメータに相当します。もう1つの便利な設定withinは、特定の場所でツイートやプロフィールを探し、ターゲットの場所からの距離で結果をフィルタリングするのに役立ちます。これはリクエスト内でnearと併用して使用する必要があります。

また、Data365のTwitter APIでは、ツイートを見つけるための他の検索オプションも利用可能です。たとえば、検索パラメータmin_favesを使用すると、最小のいいね数で結果をフィルタリングできます。min_repliesを使用すると、最小の返信数で結果をフィルタリングできます。min_retweetsを使用すると、最小のリツイート数で結果をフィルタリングできます。
パラメータcontent_filtersは、コンテンツタイプに基づいていくつかの結果を除外するのに役立ちます。

TwitterコールバックURL

TwitterのコールバックURLを使用する詳細について説明します。POSTリクエスト内でTwitterコールバックパラメータを直接指定できます。更新プロセスが終了すると、APIはこのURLにPOSTリクエストを行います。リクエストボディには、ステータスやエラー情報、読み込まれたデータ、ページネーションカーソルが含まれます。TwitterのコールバックURLは、更新データを待っている間にAPIポーリングを避けたい場合に役立ちます。

コールバックURLパラメータを指定すると、タスクのステータスを確認し、データを受信するためにGETリクエストを送信する必要がなくなることに注意してください。コールバックURLパラメータの機能についての詳細は、https://data365.co/ja/guides/callback-guideでご覧いただけます。

また、アイテムの更新タスクを作成し、このタスクが発行される間隔を選択することもできます。Twitter APIは、更新プロセスが終了するたびにPOSTリクエストを介してコールバックURLを呼び出すことができます。このパラメータは、手動で更新タスクを作成せずにアイテムを監視するのに便利です。これらの自動更新タスクは、/tasksエンドポイントを使用して取得またはキャンセルできます。

Twitter APIのレスポンス

Data365のTwitter APIを使用すると、ツイートや公開されたTwitterプロフィールに関する情報を取得できます。Twitterプロフィールに関しては、ID、ユーザー名、説明、プロフィール画像、所在地、ユーザーが提供した外部URL、フォロー数、フォロワー数、友達数、ツイート（リツイートを含む）、いいね、メディアなどの重要なデータを提供します。また、公開ツイートのみの詳細なツイートリストを受け取ることもできます。

Data365のTwitter APIを使用すると、著者ID、所在地、場所に加えて、テキスト、言語、その他のTwitterエンティティやエンゲージメントなどの大量のツイートデータを取得できます。

また、当社はクライアントにJSON形式でデータを提供していることも重要です。JSONは他の形式と比較して多くの利点があると確信しています。それには、コンパクトさ、使用や読み書きの簡便さ、そして多くの言語との互換性が含まれます。

Twitter APIの例

この例では、キーワードを使ってTwitter上のツイートを検索し、その詳細データを取得する方法を示します。

https://api.data365.co/v1.1/twitter/search/post/update?keywords=covid&from_date=2020-01-01&to_date=2021-01-01&search_type=latest&max_posts=100&access_token={TOKEN}

リクエストでは、必要なすべてのパラメータを指定できます。私たちの例では、キーワードcovidを検索しており、期間は2020年1月1日から2021年1月1日までで、検索方法はlatest（最新のツイートを検索）で、取得するツイートの数の上限は100に設定されています。

ステータス「accepted」は、リクエストが処理中であることを意味します。

その概算コストは = 7 + 1 * 100 = 107メンションです。7メンションは検索クエリ自体に、1はツイートごとのコスト、100メンションは取得するツイートの数です。したがって、107がリクエストの概算コストです。

https://api.data365.co/v1.1/twitter/search/post/update?keywords=covid&from_date=2020-01-01&to_date=2021-01-01&search_type=latest&access_token={TOKEN}

リクエストステータスには、作成、保留、完了、不明（リクエストがまだ生成されていない）、失敗（エラーによりリクエストを完了できなかった）、キャンセル（リクエストが無効にされた）の6つのオプションがあります。リクエストの処理時間は、作成から完了までの間に、リクエストの数と各リクエストのデータ量に依存し、通常は約1〜5分かかります。

https://api.data365.co/v1.1/twitter/search/post/posts?keywords=covid&search_type=latest&max_page_size=100&from_date=2020-01-01&to_date=2021-01-01&order_by=date_desc&access_token={TOKEN}

私たちは、order_by=date_descパラメータをクエリに追加しました。これにより、ツイートを最新から古い順にソートできます。したがって、レスポンスでは、元のクエリで見つかったデータを持つツイートのソートされたリストが返されます。

Twitter APIのテスト

すべてのユーザーは、Data365から14日間の無料トライアルを利用してTwitter APIをテストし、その利点を実感できます。ただし、セキュリティ上の理由から無料トライアルにはいくつかの制限があることにご注意ください。この無料トライアルにアクセスするには、https://data365.co/ja/contactまでお問い合わせください。

その結果、Data365のTwitter APIは、ツイートやプロフィールに関する大量のデータをスクレイピングするための便利なツールであると考えられます。
APIを快適にご利用いただくために、より実用的なTwitter APIの例を用意しています。また、私たちのAPIに関する役立つ専門記事を定期的に追加しているヘルプ記事もぜひご覧ください。
Data365のTwitter APIを利用することは、効果的なマーケティング戦略とリードジェネレーションを構築するための競争上の利点を得るための素晴らしい選択肢であると確信しています。