David Bartle > WWW-DomainTools > WWW::DomainTools

Download:
WWW-DomainTools-0.11.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.11   Source  

NAME ^

WWW::DomainTools - DomainTools.com XML API interface

SYNOPSIS ^

 use WWW::DomainTools qw(search_engine name_spinner);

 my $repsonse = search_engine(
        q => 'example.com',
        ext => 'COM|NET|ORG|INFO'
        key => '12345',
        partner => 'yourname',
        customer_ip => '1.2.3.4'
 );

 # OO
 my $obj = WWW::DomainTools::SearchEngine->new(
        key => '12345',
        partner => 'yourname',
        customer_ip => '1.2.3.4'
 );
 my $response = $obj->request(
        q => 'example.com',
        ext => 'COM|NET|ORG|INFO'
 );


 # Custom LWP user agent
 my $ua = LWP::UserAgent->new;
 $ua->env_proxy(true);

 my $obj = WWW::DomainTools::SearchEngine->new(
        key => '12345',
        partner => 'yourname',
        customer_ip => '1.2.3.4',
        lwp_ua => $ua
 );
 my $response = $obj->request(
        q => 'example.com',
        ext => 'COM|NET|ORG|INFO'
 );

DESCRIPTION ^

This module allows you to use the name spinner and whois search available on domaintools.com.

These methods are available as both class and object methods. Nothing is exported by default.

EXPORTS ^

None by default.

Allowed:

 - search_engine
 - name_spinner

METHODS ^

search_engine ( url parameters hash )

The keys and values expected are documented on the Domain Tools website. In addition the "search engine" specific parameters, you need to pass the required parameters as documented in the WWW::DomainTools::SearchEngine new() method.

If the request is successful, the return value is either a hash reference or a string depending on the value of the 'format' parameter to the constructor.

See the documentation for the new() method for more detailed information about 'format' and other standard parameters.

If the HTTP request fails, this method will die.

name_spinner ( url parameters hash )

The keys and values expected are documented on the Domain Tools website. In addition the "name spinner" specific parameters, you need to pass the required parameters as documented in the WWW::DomainTools::NameSpinner new() method.

If the request is successful, the return value is either a hash reference or a string depending on the value of the 'format' parameter to the constructor.

See the documentation for the new() method for more detailed information about 'format' and other standard parameters.

If the HTTP request fails, this method will die.

SEE ALSO ^

WWW::DomainTools::SearchEngine WWW::DomainTools::NameSpinner

BUGS ^

Please report bugs using the CPAN Request Tracker at http://rt.cpan.org/

AUTHOR ^

David Bartle <captindave@gmail.com>

COPYRIGHT ^

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

I am not affiliated with Domain Tools or Name Intelligence. The use of their API's are governed by their own terms of service:

http://www.domaintools.com/members/tos.html

The full text of the license can be found in the LICENSE file included with this module.

syntax highlighting: