検索API(search)

twitterのプロフィールデータにマッチするユーザ情報を取得

リクエストURL

https://twpro.jp/1/search

フォーマット

JSON

リクエストメソッド

GET

認証

なし

利用制限

5秒間に1回まで (アクセス元IP単位)

パラメータ

名前	型	説明	デフォルト
q (必須)	文字列	検索文字列(UTF-8)	-
num	数値	表示件数 (1-300)	10
callback	文字列	-	JSONPで指定する関数名

レスポンスフィールド

名前	型	説明
total	数値	マッチしたユーザの総数
count	数値	このレスポンスに含まれているユーザ情報の数
users	配列	マッチしたユーザ情報の配列

ユーザ情報

ユーザ情報は以下のフィールドで構成されます。各フィールドの内容は twitter api(users show) に準じます。

name created_at location profile_image_url url id followers_count lang description time_zone friends_count statuses_count screen_name

実行例 (JSON取得)

https://twpro.jp/1/search?q=twitter&num=3

{
  "total":69957,
  "count":3,
  "users":[
    {
      "name":"twj",
      "created_at":"Tue Jun 26 01:54 :35 +0000 2007",
      "location":"東京都渋谷区",
      "url":"http://twitter.jp",
      "id":7080152,
      "followers_count":469047,
      "lang":"ja",
      "description":"日本語版Twit terサイトの運営を手伝ってます。",
      "time_zone":"Tokyo",
  ...

実行例 (JSONP)

https://twpro.jp/1/search?q=twitter&num=1&callback=foo

foo( {"total":69957,"count":1,"users": ...