ipfinder / ipfinder
official PHP library for IPfinder
Requires
- php: ^7.0
- ext-curl: *
- ext-json: *
Requires (Dev)
- phpunit/phpunit: ^8.2.2
- squizlabs/php_codesniffer: ^3.4.2
This package is not auto-updated.
Last update: 2023-09-23 10:18:56 UTC
README
IPFinder PHP Client Library
The official PHP client library for the 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 ....)
Getting Started
singup for a free account at https://ipfinder.io/auth/signup, for Free IPFinder API access token.
The free plan is limited to 4,000 requests a day, and doesn't include some of the data fields To enable all the data fields and additional request volumes see https://ipfinder.io/pricing.
Documentation
See the official documentation.
Installation
composer require ipfinder/ipfinder
Authentication
$client = new ipfinder\ipfinder\IPfinder('YOUR_TOKEN_GOES_HERE'); // lookup your IP address information $details = $client->Authentication(); var_dump($details);
Get IP address
$client = new ipfinder\ipfinder\IPfinder('YOUR_TOKEN_GOES_HERE'); // GET Get details for 1.0.0.0 $ip_address = '1.0.0.0'; // lookup IP address information $details = $client->getAddressInfo($ip_address); var_dump($details);
Get ASN
This API available as part of our Pro and enterprise https://ipfinder.io/pricing.
$client = new ipfinder\ipfinder\IPfinder('YOUR_TOKEN_GOES_HERE'); $asn = 'as36947'; // lookup Asn information $details = $client->getAsn($asn); var_dump($details); // get and print continent name echo $details->continent_name."\n"; // get and print speed echo $details->speed['ping']."\n";
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
$client = new ipfinder\ipfinder\IPfinder('YOUR_TOKEN_GOES_HERE'); $asn = 'as36947'; // lookup Asn information $details = $client->getFirewall($asn,'nginx_deny'); var_dump($details);
Get IP Address Ranges
This API available as part of our enterprise https://ipfinder.io/pricing.
Make sure to convert Organization name into URL encoding
$client = new ipfinder\ipfinder\IPfinder('YOUR_TOKEN_GOES_HERE'); // Organization name $org = 'Telecom Algeria'; // lookup Organization information $details = $client->getRanges($org); var_dump($client); // print Organization name url encode echo $client->urlencode;
Get service status
$client = new ipfinder\ipfinder\IPfinder('YOUR_TOKEN_GOES_HERE'); // lookup IP TOKEN information $details = $client->getStatus(); var_dump($details); // get and print Number of IP address queries left for the day echo $details->queriesLeft."\n";
Get Domain IP
use ipfinder\ipfinder\IPfinder; // Token $client = new IPfinder('YOUR_TOKEN_GOES_HERE'); // domain name $name = 'google.com'; $details = $client->getDomain($name); var_dump($details);
Get Domain IP history
use ipfinder\ipfinder\IPfinder; // Token $client = new IPfinder('YOUR_TOKEN_GOES_HERE'); // domain name $name = 'google.com'; $details = $client->getDomainHistory($name); var_dump($details);
Get list Domain By ASN, Country,Ranges
use ipfinder\ipfinder\IPfinder; // Token $client = new IPfinder('YOUR_TOKEN_GOES_HERE'); // list live domain by country DZ,US,TN,FR,MA $by = 'DZ'; $details = $client->getDomainBy($by); var_dump($details);
Add proxy
$client = new ipfinder\ipfinder\IPfinder('YOUR_TOKEN_GOES_HERE', 'https://ipfinder.yourdomain.com');
Error handling
$client = new IPfinder('YOUR_TOKEN_GOES_HERE'); try { $by = 'DZ'; $details = $client->getDomainBy($by); } catch (IPfinderException $e) { print $e->getMessage(); }
Contact
Contact Us With Additional Questions About Our API, if you would like more information about our API that isn’t available in our IP geolocation API developer documentation, simply contact us at any time and we’ll be able to help you find what you need.