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": "&lt;a href=&quot;http://www.facebook.com/twitter&quot; rel=&quot;nofollow&quot;&gt;Facebook&lt;/a&gt;",
      "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のレスポンスフィールド

Search API (ツイートの検索)

リクエスト

レスポンス

プロパティ

参考