NAME

WWW::FoneFinder - Provides an interface to FoneFinder.net

SYNOPSIS

use WWW::FoneFinder;
my $ff = WWW::FoneFinder->new;
my $phone = $ff->query('4079347639'); # 407-W-DISNEY (Disney Reservations)
use Data::Dumper;
print Dumper($phone);

DESCRIPTION

Put in a phone number and it will give you the city, state, and telco for that number. The data comes from FoneFinder.net. This only provides data for NANPA phone numbers (US/Canada).

new

Creates WWW::FoneFinder object.

query

Queries the site. Provide a phone number. It only sends the area code (NPA), prefix (NXX), and first digit of the last four.

Do not include a country code. Do not provide a "1" prefix. Use only the ten-digit phone number. It is okay to include hyphens/dashes/etc; non-digit characters will be removed automatically.

Format must be: NPANXXNNNN (1234567890: 123 = areacode, 456 = prefix, 7890 = last four digits).

If you provide "4079347639", it will send 407, 934, and 7. It will not send the last three digits 639 as they are not useful (plus an added privacy bonus).

COPYRIGHT AND LICENSE

Copyright (C) 2009 Dusty Wilson, <dusty@megagram.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.