IPSquads PHP library for IP Address Geolocation, Timezone, Currency & other information.
IPSquads is helping many companies & organizations for various use-cases:
- Content Localization
- Analytics
- Fraud Prevention
- Targeted online advertising
- Geographic rights management
By default, requests are throttled at 20 requests per minute if access key is not passed. You can remove this throttle limit by getting a FREE access key through which you can make 1000 unthrottled requests per day.
If you are a non-profit organization, you may request to increase this limit. You can drop us a mail at support@ipsquads.com.
If you would like to upgrade for more than 1000 requests per day, you may select the plan here: https://ipsquads.com/product/
In-order to get started,
You can install the package via composer:
composer require ipsquads/phpTo get all the details of an IP Address.
use Ipsquads\Php\IPSquads;
$access_key = 'FREE';
$ip_squads = new IPSquads($access_key);
$ip_data = $ip_squads->getDetails('54.70.143.245');{
"ip_address": "54.70.143.245",
"ip_type": "IPv4",
"country_name": "United States",
"country_code": "US",
"country_languages": "en-US,es-US,haw,fr",
"continent_code": "NA",
"continent_name": "North America",
"city": "Boardman",
"zip": "97818",
"region_name": "Oregon",
"region_code": "USOR",
"latitude": 45.83986,
"longitude": -119.70058,
"asn": {
"asn": 16509,
"asn_org": "AMAZON-02"
},
"location": {
"is_eu": false,
"postal_regex": "^d{5}(-d{4})?$",
"capital": "Washington",
"calling_code": "1"
},
"timezone": {
"code": "America/Los_Angeles",
"dst_offset": -7,
"gmt_offset": -8,
"current_time": "2020-10-12T22:52:09.911223+05:30",
"current_time_unix": "1602523329.911223"
},
"currency": {
"name": "Dollar",
"code": "USD"
}
}If you are interested in only currency details, you can use the below method.
use Ipsquads\Php\IPSquads;
$access_key = 'FREE';
$ip_squads = new IPSquads($access_key);
$ip_data = $ip_squads->getCurrencyDetails('54.70.143.245');If you are interested in only getting the timezone details of a visitor based on the IP Address, you can do that using the below method.
use Ipsquads\Php\IPSquads;
$access_key = 'FREE';
$ip_squads = new IPSquads($access_key);
$ip_data = $ip_squads->getTimezoneDetails('54.70.143.245');If you are only looking for the network details of an IP Address, you can do using the below method.
use Ipsquads\Php\IPSquads;
$access_key = 'FREE';
$ip_squads = new IPSquads($access_key);
$ip_data = $ip_squads->getNetworkDetails('54.70.143.245');By default, any result returned from IPSquads server are cached for quick access & prevent you from using more credits unnecessarily.
Under the hood, this SDK uses symfony/cache library for caching.
The default TTL of cache is 3600 seconds. If you would like to increase or decrease this limit, you can do so by modifying the way IPSquads is getting initialized.
use Ipsquads\Php\IPSquads;
$access_key = 'FREE';
$settings = [
'expires_after' => '1000'
];
$ip_squads = new IPSquads($access_key, $settings);As a default, FilesystemAdapter cache is used. If you would like to use any other adapter of symfony/cache library, you can do so by passing the instance of a Cache Adapter. To check the available cache adapters, click here.
use Ipsquads\Php\IPSquads;
use Symfony\Component\Cache\Adapter\ApcuAdapter;
$access_key = 'FREE';
$settings = [
'cache_adapter' => (new ApcuAdapter)
];
$ip_squads = new IPSquads($access_key, $settings);composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The Apache License. Please see License File for more information.