NAME

Webservice::InternetDB::API - Fast IP Lookups for Open Ports and Vulnerabilities using InternetDB API

SYNOPSIS

    use v5.40;
    use Webservice::InternetDB::API;

    # get information about this current machine:
    my $response = Webservice::InternetDB::API->new()->get();

    # get information about another machine:
    $response = Webservice::InternetDB::API->new()->get('1.1.1.1');

    # re-use the same object:
    my $api = Webservice::InternetDB::API->new();
    $api->get('1.1.1.1');

DESCRIPTION

This module provides an object oriented interface via the keyword "class" feature to the InternetDB free API endpoint provided by https://internetdb.shodan.io/. Shodan also provides much more robust paid services with subscription that this module does not provide access to.

METHODS

get()

Accepts a string that is the IP address to be scanned. Returns a hash reference with the results of the scan.

example response:

    {
        cpes        [],
        hostnames   [
            "one.one.one.one"
        ],
        ip          "1.1.1.1",
        ports       [
            53,
            80,
            443,
            2082,
            2083,
            2087,
            8080,
            8443,
            8880
        ],
        tags        [],
        vulns       []
    }

SEE ALSO

Call for API implementations on PerlMonks: https://perlmonks.org/?node_id=11161472

Listed at freepublicapis.com: https://www.freepublicapis.com/ipify-api

Official api webpage: https://www.ipify.org/

AUTHOR

Joshua Day, <hax@cpan.org>

SOURCECODE

Source code is available on Github.com : https://github.com/haxmeister/perl-InternetDB

COPYRIGHT AND LICENSE

Copyright (C) 2024 by Joshua Day

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