ホーム > PHP と Twitter > Twitter API > Users（ユーザー） > ユーザーを検索して結果を取得 users search twitter

ユーザーを検索して結果を取得 users search twitter

2012年のTwitter APIの記事です。

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

目次 [閉じる]

1. Twitter API users/search

Twitter API users/search

API Resource

GET users/search

概要

　条件を指定してユーザー検索を行います。

このAPIは、Twitter.com上の「Find People(友達検索)」同じような検索機能を提供します。また、Twitter.com上の「People Search(ユーザー検索)」と同じ結果をこのAPIで取得できます。
条件に一致した検索結果の最初の1000件分を取得できます。
API GET search とは異なり、検索条件を作成するために便利な「演算子」がサポートされていません。演算子を用いる検索条件は指定できません。

原文

https://dev.twitter.com/docs/api/1/get/users/search

Resource URL（リソースURL）

http://api.twitter.com/1/users/search.format

Resource Information（リソース情報）

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

Parameters（パラメーター）

q ※必須	サンプル値：witter%20API	ユーザー検索クエリを指定します。ユーザー名や screen_name を指定します。
page ※オプション	サンプル値：3	ページ数を指定します。ページ数は、検索条件に一致した取得結果をパラメーターper_pageで指定した1ページ当たりの件数か最大20件で分割された数です。
per_page ※オプション	サンプル値：5	1ページ当たりの表示件数を指定します。最大20件
include_entities ※オプション	サンプル値：true	このパラメータを true または 1 にすると、ステータス情報に entities情報が含まれるようになります。entities情報はそのステータス情報に関連するuser_mentions, urls, hashtagsなどのメタデータです。entitiesの詳細はこちらを参照下さい。

サンプルコード

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

– サンプル Click Here ! –

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<head>
<meta name="robots" content="index">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Twitter API users search twitterユーザーを検索して結果を取得 表示</title>
</head>
<body>

<?php
#########################################
### 初期設定
//twitteroauth.phpをインクルードします。ファイルへのパスは環境に合わせて記述下さい。
require_once("./twitteroauth.php");

//Consumer keyの値をTwitterAPI開発者ページでご確認下さい。
$consumerKey = "***************";
//Consumer secretの値を格納
$consumerSecret = "***********************************";
//Access Tokenの値を格納
$accessToken = "***********************************";
//Access Token Secretの値を格納
$accessTokenSecret = "***********************************";

//OAuthオブジェクトを生成する
$twObj = new TwitterOAuth($consumerKey,$consumerSecret,$accessToken,$accessTokenSecret);
?>

<?php
#########################################
### ページ説明
?>

<h1>Twitter API users search twitterユーザーを検索して結果を取得 表示</h1>
<!-- 説明ページurl -->
<h3><a href="https://wepicks.net/2012/01/25/phpapptwitter-users_search/">→説明はこちら</a></h3>
<hr/>

<?php
#########################################
### 取得したデータを展開
?>

<h2>取得したデータを展開</h2>
<div style="background-color:#f8f8f8;margin:20px; padding:20px; border:solid #cccccc 1px;">

<!-- // =========================== ここから =========================== -->

<?php
//API実行データ取得
$vRequest = $twObj->OAuthRequest("http://api.twitter.com/1/users/search.xml","GET",array('q' => 'php'));

//XMLデータをsimplexml_load_string関数を使用してオブジェクトに変換する
$oXml = simplexml_load_string($vRequest);

//オブジェクトを展開
if(isset($oXml->error) && $oXml->error != ''){
    echo "取得に失敗しました。<br/>\n";
    echo "パラメーターの指定を確認して下さい。<br/>\n";
    echo "エラーメッセージ:".$oXml->error."<br/>\n";
}else{
    foreach($oXml->user as $oObject){
        echo "user_id:(".$oObject->id.")<br/>\n";
        echo "name:(".$oObject->name.")<br/>\n";
        echo "screen_name:(".$oObject->screen_name.")<br/>\n";
        echo '<hr/>';
    }
}
?>

<!-- =========================== ここまで =========================== // -->
</div>
<hr/>

<?php
#########################################
### 取得したオブジェクトの内容
?>

<h2>取得したオブジェクトの内容</h2>
<?php
var_dump($oXml);
?>
<hr/>

</body>
</html>