ホーム > PHP と Twitter > Twitter API > Lists（リスト） > リストの購読者一覧を取得 lists subscribers

リストの購読者一覧を取得 lists subscribers

2012年のTwitter APIの記事です。

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

目次 [閉じる]

1. Twitter API lists/subscribers

Twitter API lists/subscribers

API Resource

GET lists/subscribers

概要

　指定したリストを購読しているユーザー一覧を返します。

パラメーター list_id か slug どちらかが必須です。パラメーター slug を指定した場合は、owner_screen_name か owner_id を指定します。

認証ユーザー(自分)が指定したリストの所有者の場合、プライベートリストの購読者にのみ表示されます。

本文

https://dev.twitter.com/docs/api/1/get/lists/subscribers

Resource URL（リソースURL）

https://api.twitter.com/1/lists/subscribers.format

Resource Information（リソース情報）

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

Parameters（パラメーター）

パラメーター list_id か slug どちらかが必須です。パラメーター slug を指定した場合は、owner_screen_name か owner_id を指定します。

list_id ※必須	サンプル値：	リストの数値IDを指定します。
slug ※必須	サンプル値：	数値IDの変わりにスラッグ名によっていリストを識別することが出来ます。パラメータ slug を指定する場合、パラメーター owner_screen_name か owner_id によってリストの所有者を指定する必要があります。
owner_screen_name ※オプション	サンプル値：tryphp	パラメーター slug によって要求されているリストの所有者の screen_name を指定します。
owner_id ※オプション	サンプル値：123	パラメーター slug によって要求されているリストの所有者のユーザーID を指定します。
cursor ※オプション	サンプル値：12893764510938	カーソル(cursor)位置を指定して結果をページ分割します。これは、一覧を取得するためにTwitter.comデータベースに指定するカーソル位置です。指定したカーソル位置からリストを20件取得します。-1を指定した場合、最新から20件分取得します。20以上分はページに分割されます。その場合、「次のページ(next_cursor)」と「前のページ(previous_cursor)」を示すカーソル位置を示す値が取得でき、それらを指定することが出来ます。
include_entities ※オプション	サンプル値：true	このパラメータを true または 1 にすると、ステータス情報に entities情報が含まれるようになります。entities情報はそのステータス情報に関連するuser_mentions, urls, hashtagsなどのメタデータです。entitiesの詳細はこちらを参照下さい。
skip_status ※オプション	サンプル値：true	このパラメータを true にすると、ステータス情報にユーザーオブジェクトが含まれなくなります。

サンプルコード

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">
<meta name="robots" content="index">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<head>
<title>Twitter API lists subscribers リストの購読者 一覧 取得 表示</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 lists subscribers リストの購読者 一覧 取得 表示</h1>
<!-- 説明ページurl -->
<h3><a href="https://wepicks.net/2012/01/29/phpapptwitter-lists_subscribers/">→説明はこちら</a></h3>
<hr/>

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

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

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

<?php
//API実行データ取得
$vRequest = $twObj->OAuthRequest("https://api.twitter.com/1/lists/subscribers.xml","GET",array('slug' => 'media-content', 'owner_screen_name' => 'tsuda'));

//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->users->user as $oUser){
        echo "ユーザーid:(".$oUser->id.")<br>\n";
        echo "ユーザー名:(".$oUser->name.")<br>\n";
        echo "ユーザーscreen_name:(".$oUser->screen_name.")<br>\n";
        echo "<hr/>\n";
    }
}
?>

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

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

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

</body>
</html>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<head>

<title>Twitter API lists subscribers リストの購読者一覧取得表示</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 lists subscribers リストの購読者一覧取得表示</h1>

<h3><a href="https://wepicks.net/2012/01/29/phpapptwitter-lists_subscribers/">→説明はこちら</a></h3>

<hr/>

<?php

#########################################

### 取得したデータを展開

<h2>取得したデータを展開</h2>

<?php

//API実行データ取得

$vRequest = $twObj->OAuthRequest("https://api.twitter.com/1/lists/subscribers.xml","GET",array('slug' => 'media-content', 'owner_screen_name' => 'tsuda'));

//XMLデータをsimplexml_load_string関数を使用してオブジェクトに変換する

$oXml = simplexml_load_string($vRequest);

//オブジェクトを展開