NAME

Net::Twitter::Role::API::Lists - Twitter Lists API support for Net::Twitter

SYNOPSIS

use Net::Twitter;

my $nt = Net::Twitter->new(traits => ['API::Lists'], ...);

$list = $nt->create_list($owner, { name => $name, description => $desc });
$list = $nt->update_list($owner, $list_id, { description => $desc });

$lists = $nt->get_lists($owner);
$lists = $nt->list_lists($owner);

$list = $nt->get_list($owner, $list_id);
$list = $nt->delete_list($owner, $list_id);

$statuses = $nt->list_statuses($owner, $list_id);

$lists = $nt->list_memberships($owner);
$lists = $nt->list_subscriptions($owner);

$users = $nt->list_members($owner, $list_id);

$user_or_undef = $nt->list_members($owner, $list_id, { id => $user_id });

$user = $nt->add_list_member($owner, $list_id, $user_id);
$users = $nt->add_list_members($owner, $list_id, { screen_name => \@screen_names });

$user = $nt->delete_list_member($owner, $list_id, $user_id);
$user = $nt->remove_list_member($owner, $list_id, $user_id);

$user_or_undef = $nt->is_list_member($owner, $list_id, $user_id);

$users = $nt->list_subscribers($owner, $list_id);

$list = $nt->subscribe_list($owner, $list_id);
$list = $nt->unsubscribe_list($owner, $list_id);

$user_or_undef = $nt->is_subscribed_list($owner, $list_id, $user_id);
$user_or_undef = $nt->is_list_subscriber($owner, $list_id, $user_id);

#############################
# With the cursor parameter #
#############################

$r = $nt->get_list($user, $list_id, { cursor => $cursor });
$lists = $r->{lists};

$r = $nt->list_memberships($user, { cursor => $cursor });
$lists = $r->{lists};

$r = $nt->list_subscriptions($user, { cursor => $cursor });
$lists = $r->{lists};

$r = $nt->list_members($owner, $list_id, { cursor => $cursor });
$users = $r->{users};

$r = $nt->list_subscribers($owner, $list_id, { cursor => $cursor });
$users = $r->{users};

DESCRIPTION

This module adds support to Net::Twitter for the Twitter Lists API.

DESCRIPTION

Net::Twitter::Role::API::Lists provides a trait for the Twitter Lists API methods. See Net::Twitter for full documentation.

SEE ALSO

Net::Twitter

AUTHOR

Marc Mims <marc@questright.com>

COPYRIGHT

Copyright (c) 2009-2010 Marc Mims

LICENSE

This library is free software. You may redistribute and modify it under the same terms as Perl itself.