NAME

WWW::Foursquare::RSS - Perl interface to the Foursquare.com RSS feeds

SYNOPSIS

  use WWW::Foursquare::RSS;

  my $key        = '1234567890';
  my $foursquare = WWW::Foursquare::RSS->new($key);
  my @checkins   = $foursquare->get_checkins(count => 1);
  my $checkin    = shift @checkins;
  print "I was last seen at " . $checkin->venue_name;

DESCRIPTION

This module provides an object-oriented Perl interface to the Foursquare.com RSS feeds.

Note that this module isn't intended for use in production applications - that's what the official Foursquare API is for. This is just for Perl hackers who want easy access to their checkin history.

METHODS

new

Returns a new instance of WWW::Foursquare. Accepts (and requires) your private token as a parameter.

You can find your private token at http://foursquare.com/feeds/ - it is the alphanumeric string between "/history/" and ".rss" in the RSS feed link.

get_checkins

Returns an array of WWW::Foursquare::RSS::Checkin objects representing your checkins.

Accepts the following optional parameters:

count - The number of checkins to return (defaults to 25)

DEPENDENCIES

DateTime, Date::Parse, XML::Simple, LWP::Simple

DISCLAIMER

The author of this module is not affiliated in any way with Foursquare.

Users of this module must be sure to follow the Foursquare terms of service.

COPYRIGHT AND LICENSE

Copyright (C) 2010 Michael Aquilina. All rights reserved.

This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Michael Aquilina, aquilina@cpan.org