The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
IO-IPFinder-1.0
River stage zero No dependents
1 ++
/ IO::IPFinder

NAME

IO::IPFinder - The official Perl library for IPFinder ipfinder.io. https://github.com/ipfinder-io/ip-finder-perl.

SYNOPSIS The official Perl client library for the [IPFinder.io](https://ipfinder.io)

With `free` TOKEN

usage is quite simple:

    use Data::Dumper qw(Dumper);

    $ipfinder = IO::IPFinder->new(); #  emty token == free

    # lookup your IP address information
    $auth = $ipfinder->Authentication();

    print Dumper $auth;

Authentication

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    # lookup your IP address information
    $auth = $ipfinder->Authentication();

    # lookup your IP address information
    $auth = $ipfinder->Authentication();

    print Dumper $auth;

Get IP address

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    # GET Get details for 1.0.0.0

    $ip = $ipfinder->getAddressInfo('1.0.0.0');

    print $ip->{ip};

    print $ip->{country_code};

Get ASN This API available as part of our Pro and enterprise [https://ipfinder.io/pricing](https://ipfinder.io/pricing).

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    # lookup Asn information
    $asn = $ipfinder->getAsn('AS1');

    print $asn->{asn}; # AS number

    print $asn->{org_name}; # Organization name

Firewall This API available as part of our enterprise https://ipfinder.io/pricing/ formats supported are : `apache_allow`, `apache_deny`,`nginx_allow`,`nginx_deny`, `CIDR`, `linux_iptables`, `netmask`, `inverse_netmask`, `web_config_allow `, `web_config_deny`, `cisco_acl`, `peer_guardian_2`, `network_object`, `cisco_bit_bucket`, `juniper_junos`, `microtik` sample: use IO::IPFinder; use Data::Dumper qw(Dumper);

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    $asn = 'as36947';

    # lookup Asn information

    $data = $ipfinder->getFirewall($asn, 'nginx_deny');

    print Dumper $data
=head2 Get IP Address Ranges
This API available as part of our  enterprise L<https://ipfinder.io/pricing/>
sample:
    use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    # Organization name
    $org = 'Telecom Algeria';

    # lookup Organization information
    $data = $ipfinder->getRanges($org);

    print $range->{num_ranges};

    print $range->{num_ipv4};

    print $range->{num_ipv6};

Get service status

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    # lookup TOKEN information
    $data = $ipfinder->getStatus();

    print $ip->{queriesPerDay};

    print $ip->{queriesLeft};

    print $ip->{key_info};

Get Domain IP

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    #  domain name
    $name = 'google.com';

    $data = $ipfinder->getDomain($name);

    print $data->{domain_status };

    print $data->{ip};

    print $data->{country_code};

Get Domain IP history

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    # domain name
    $name = 'google.com';

    $data = $ipfinder->getDomainHistory($name);

    print $data->{total_domain};

    print $data->{list_domain};
=head2 Get list Domain By ASN, Country,Ranges

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE');

    # list live domain by country DZ,US,TN,FR,MA
    $by = 'DZ';

    $dby = $ipfinder->getDomainBy($by);

    print $dby->{select_by}; # Returns Requested $select_by ASN,Country,Ranges

    print $dby->{total_domain}; # Returns number of domain

Add proxy

sample: use IO::IPFinder;

    $ipfinder = IO::IPFinder->new('YOUR_TOKEN_GOES_HERE','https://ipfinder.yourdomain.com');

DESCRIPTION

The official Perl client library for the [IPFinder.io](https://ipfinder.io) get details for : - IP address details (city, region, country, postal code, latitude and more ..) - ASN details (Organization name, registry,domain,comany_type, and more .. ) - Firewall by supported formats details (apache_allow, nginx_deny, CIDR , and more ..) - IP Address Ranges by the Organization name details (list_asn, list_prefixes , and more ..) - service status details (queriesPerDay, queriesLeft, key_type, key_info) - Get Domain IP (asn, organization,country_code ....) - Get Domain IP history (total_ip, list_ip,organization,asn ....) - Get list Domain By ASN, Country,Ranges (select_by , total_domain , list_domain ....)

Documentation

SUPPORT You can find documentation for this module with the perldoc command. perldoc IO::IPFinder You can also look for information at:

Sample codes under examples/ folder.

AUTHOR

Mohamed Ben rebia <mohamed@ipfinder.io>

COPYRIGHT AND LICENSE

Copyright 2019 Mohamed Benrebia <mohamed@ipfinder.io>

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.