Search API (ツイートの検索)

このページの内容は古くなっており、もう使用できません。

Search APIでは、Twitter検索の結果をJSON形式で取得できます。

リクエスト

GET http://search.twitter.com/search.json?

qパラメータ以外の指定は任意です。

パラメータ 説明 記述例
q 検索クエリ。これはURLエンコードされている必要がある。複雑なクエリは制限を受ける。

検索クエリには標準のものが使用できる。ただしnear:演算子は使用できず、代わりにgeocodeパラメータを使用する。

@noradio
callback If supplied, the response will use the JSONP format with a callback of the given name.

※ Only available for JSON format.

 
geocode 指定された緯度・経度の半径内に位置するユーザーのツイートを取得する。その位置はGeotagging APIから取得するが、それができなければユーザーのプロフィールから取得する。パラメータは"緯度,経度,半径"で指定し、半径は
  • "mi" (マイル)
  • "km" (キロメーター)
のいずれかの単位を明示する。
37.781157,-122.398720,1mi
lang 取得するツイートを指定した言語に制限する。言語はISO 639-1コードで指定する。 ja
locale Specify the language of the query you are sending (only ja is currently effective). This is intended for language-specific clients and the default should work in the majority of cases. ja
page ページ番号。番号は1から始める。

結果の上限は約1500であるため、最大値はrppで除算したときにその数を超えない値。たとえばrppが100ならば、pageの上限は1500/100で15となる。

10
result_type レスポンスで受け取る結果の種類を指定する。
  • mixed: 人気があるものとリアルタイムのもの
  • recent: もっとも最近のものだけ
  • popular: もっとも人気があるものだけ
既定値は「mixed」
mixed, recent, popular
rpp ページあたりで返されるツイートの数 (Return Per Page : rpp)

最大値は100

100
show_user When true, prepends ":" to the beginning of the tweet. This is useful for readers that do not display Atom's author field. The default is false.  
until Optional. Returns tweets generated before the given date. Date should be formatted as YYYY-MM-DD. 2010-03-28
since_id Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available. 12345
include_entities true、tまたは1のとき、おのおののツイートはentitiesと呼ばれるノードを含む。このノードはURLやハッシュタグなどの、ツイートのメタデータを提供する。

Note that user mentions are currently not supported for search and there will be no "user_mentions" key in the entities map.

See Tweet Entities for more detail on entities. Please note that entities are only available for JSON responses in the Search API.

true

レスポンス

http://search.twitter.com/search.json?q=blue%20angels&include_entities=true
{

  "completed_in": 0.021,
  "max_id": 167438090607140860,
  "max_id_str": "167438090607140865",
  "next_page": "?page=2&max_id=167438090607140865&q=blue%20angels&include_entities=1",
  "page": 1,
  "query": "blue+angels",
  "refresh_url": "?since_id=167438090607140865&q=blue%20angels&include_entities=1",
  "results": [
    {

      "created_at": "Thu, 09 Feb 2012 02:42:06 +0000",
      "entities": {
        "hashtags": [ ],
        "urls": [
          {
            "url": "http://t.co/WvZyVY14",
            "expanded_url": "http://www.youtube.com/watch?v=W6tB8Lf7YoU",
            "display_url": "youtube.com/watch?v=W6tB8L…",
            "indices": [
              30,
              50
            ]
          },
          {
            "url": "http://t.co/rTEjH3Kc",
            "expanded_url": "http://fb.me/1yMWWEKVz",
            "display_url": "fb.me/1yMWWEKVz",
            "indices": [
              51,
              71
            ]
          }
        ],
        "user_mentions": [ ]
      },
      "from_user": "chimesaviation",
      "from_user_id": 78866876,
      "from_user_id_str": "78866876",
      "from_user_name": "All About Flying",
      "geo": null,
      "id": 167438090607140860,
      "id_str": "167438090607140865",
      "iso_language_code": "en",
      "metadata": {
        "result_type": "recent"
      },
      "profile_image_url": "http://a3.twimg.com/profile_images/1530897095/tw_12374369_1315283368_normal.jpg",
      "profile_image_url_https": "https://si0.twimg.com/profile_images/1530897095/tw_12374369_1315283368_normal.jpg",
      "source": "<a href="http://www.facebook.com/twitter" rel="nofollow">Facebook</a>",
      "text": "BLUE ANGELS - Up, Up & Away!\n\nhttp://t.co/WvZyVY14 http://t.co/rTEjH3Kc",
      "to_user": null,
      "to_user_id": null,
      "to_user_id_str": null,
      "to_user_name": null

    },
    {
      ...
    }
  ],
  "results_per_page": 15,
  "since_id": 0,
  "since_id_str": "0"

}

プロパティ

プロパティ 説明 取得例
completed_in   0.021
query 検索クエリ "blue+angels"
refresh_url   "?since_id=167438090607140865&q=blue%20angels&include_entities=1"
results 検索に一致した結果の配列 [ ... ]
  since_id 結果の最初のツイートID 0
since_id_str 結果の最初のツイートID (文字列) "0"
  max_id 結果の最後のツイートID 167438090607140860
max_id_str 結果の最後のツイートID (文字列) "167438090607140865"
ページ page ページ番号 1
next_page   "?page=2&max_id=167438090607140865&q=blue%20angels&include_entities=1"
results_per_page ページあたりの結果数 15
results
プロパティ 説明 取得例
created_at 投稿日時 (UTC時間) "Thu, 09 Feb 2012 02:42:06 +0000"
entities   { ... }
geo ツイートされた位置 { coordinates: [35.0000, 140.0000], type: "Point" }
  id ツイートのID 167438090607140860
id_str ツイートのID (文字列) "167438090607140865"
iso_language_code 言語 "en"
metadata   { "result_type": "recent" }
  profile_image_url プロフィールの画像 "http://a3.twimg.com/profile_images/1530897095/tw_12374369_1315283368_normal.jpg"
profile_image_url_https   "https://si0.twimg.com/profile_images/1530897095/tw_12374369_1315283368_normal.jpg"
source   "<a href="http://www.facebook.com/twitter" rel="nofollow">Facebook</a>"
text ツイートの内容 "BLUE ANGELS - Up, Up & Away!\n\nhttp://t.co/WvZyVY14 http://t.co/rTEjH3Kc"
送信元 from_user 送信元のユーザー "chimesaviation"
from_user_id 送信元のユーザーID 78866876
from_user_id_str 送信元のユーザーID (文字列) "78866876"
from_user_name 送信元のユーザー名 "All About Flying"
返信元 to_user   null
to_user_id   null
to_user_id_str   null
to_user_name   null
entities
プロパティ 説明 取得例
hashtags   [ ... ]
media   [ ... ]
urls   [ ... ]
user_mentions ツイートで言及した他のユーザー [ ... ]
hashtags
プロパティ 取得例
text  
urls
プロパティ 取得例
url "http://t.co/WvZyVY14"
expanded_url "http://www.youtube.com/watch?v=W6tB8Lf7YoU"
display_url "youtube.com/watch?v=W6tB8L…"
indices [30, 50]
user_mentions
プロパティ 説明
id ユーザーID
id_str ユーザーID (文字列)
name ユーザー名
screen_name ユーザーの表示名

Twitterのレスポンス フィールド