menu
ホーム > PHP と Twitter > Twitter API > Search(検索) > つぶやきを検索します search

つぶやきを検索します search

2012年のTwitter APIの記事です。

参考資料として掲載しておきます。


Twitter API statuses/update

API Resource

GET search

概要

 指定内容でTwitter.comの「つぶやき」を検索してステータス情報(各つぶやきとそれに関連する諸々の情報)を返します。

POINT
パラメーター q で指定する検索ワードは、 urlencode() 関数でURLエンコードします。また、and検索 や or検索 も指定できます。

  • and 検索は、検索ワードを「+」で繋ぐ「'q' => 'a+b'」a と b 両方ある場合に取得
  • or 検索は、検索ワードを「+OR+」で繋ぐ「'q' => 'a+OR+b'」a か b どちらかある場合に取得
  • not 検索は、除外したい検索ワードの前に「-」をつける 「'q' => '-a'」a以外は取得
  • フレーズ検索は、検索ワードを「"」で囲む「'q' => '"word"'」wordという単語は取得

Resource URL(リソースURL)

http://search.twitter.com/search.format

Resource Information(リソース情報)

Rate Limited(制限)Yes(あり)
Requires Authentication(認証)No(なし)
Response Formats(フォーマット)json atom
HTTP Methods(HTTPメソッド)GET

Parameters(パラメーター)

検索クエリの言語を指定します。

ページ番号を指定します。これはrppパラメータで指定した件数を1ページあたりの件数とした場合に、「検索結果の総件数/rpp件数」で「総ページ件数」となり、何ページ目かを指定します。検索の最大取得件数は1500件です。rppの最大数は100件です。

検索結果の1ページ分の件数を指定します。最大100件まで指定出来ます。

q
※必須
サンプル値:@noradio検索内容を指定します。指定内容はURLエンコードする必要があります。通常では最大15件返します。URLエンコードした状態で140文字以内で指定する必要があります。
callback
※オプション
JSON形式の場合にのみ利用できます。コールバック名を指定します。指定した場合、指定された名前のコールバック名でJSONP形式を得ることが出来ます。
geocode
※オプション
サンプル値:37.781157,-122.398720,1mi経度、緯度、半径を指定して、指定された経度緯度を中心に指定された半径の範囲内にあるユーザーつぶやきを返します。半径のパラメータはマイル[mi]/キロメートル[km]の単位を指定します。

geocodeパラメータの検索対象となる位置は、Geotaggingに対応したAPI経由で発信されたつぶやきが優先されます。Twitterユーザのプロフィールに設定された位置情報にフォールバックします。

lang
※オプション
ISO 639-1コードで指定された特定の言語を検索対象とします。
local
※オプション
サンプル値:ja
page
※オプション
サンプル値:10
result_type
※必須
サンプル値:mixed, recent, popular検索結果を受信する種類を指定します。タイプは3つあります。指定しない場合は「mixed」となります。

  • mixed:「新しいつぶやき」と「評価の高いつぶやき」の両方を適切に検索結果として返します。
  • recent:「新しいつぶやき」を優先的に検索結果として返します。
  • popular:「評価の高いつぶやき」を優先的に検索結果として返します。
rpp
※オプション
サンプル値:100
show_user
※オプション
サンプル値:truetrueにした場合つぶやきの先頭に「:」を付加します。
until
※オプション
サンプル値:2010-03-28指定された日付前に生成されたつぶやきを返します。日付はYYYY-MM-DD形式で指定する必要があります。
since_id
※オプション
サンプル値:12345指定されたIDより大きいID、つまり新しいIDのステータス情報を返します。APIを通してアクセス可能なidには制限があります。制限より小さいid、つまり過去のidを指定した場合は、利用可能な最も古いidが強制されます。
include_entities
※オプション
サンプル値:trueこのパラメータを true または 1 にすると、ステータス情報に entities情報が含まれるようになります。entities情報はそのステータス情報に関連するuser_mentions, urls, hashtagsなどのメタデータです。entitiesの詳細はこちらを参照下さい。

サンプルコード

POINT
以下のサンプルコードを実行するにはOAuth接続が必要です。こちらのページからOAuth接続の設定を行って下さい。

– サンプル Click Here ! –

– サンプル Click Here ! –

タグ(=記事関連ワード)

タグ: ,

日付

投稿日:2012年1月17日
最終更新日:2023年09月04日

このカテゴリの他のページ

この記事へのコメント

トラックバックurl

https://wepicks.net/phpapptwitter-search/trackback/

page top