{"id":22753001,"url":"https://github.com/kianmeng/webservice-ipstack","last_synced_at":"2025-03-30T07:17:31.682Z","repository":{"id":56835567,"uuid":"165486629","full_name":"kianmeng/webservice-ipstack","owner":"kianmeng","description":"The Perl helper library for IP Stack's Geolocation API, https://ipstack.com","archived":false,"fork":false,"pushed_at":"2019-04-30T13:15:13.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-05T09:26:39.593Z","etag":null,"topics":["api","cpan","geoip","ipstack","ipv4","ipv6","perl"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kianmeng.png","metadata":{"files":{"readme":"README.md","changelog":"Changes","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-13T09:15:16.000Z","updated_at":"2019-05-26T16:00:43.000Z","dependencies_parsed_at":"2022-09-09T14:01:59.267Z","dependency_job_id":null,"html_url":"https://github.com/kianmeng/webservice-ipstack","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kianmeng%2Fwebservice-ipstack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kianmeng%2Fwebservice-ipstack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kianmeng%2Fwebservice-ipstack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kianmeng%2Fwebservice-ipstack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kianmeng","download_url":"https://codeload.github.com/kianmeng/webservice-ipstack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246285817,"owners_count":20752958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","cpan","geoip","ipstack","ipv4","ipv6","perl"],"created_at":"2024-12-11T06:08:29.753Z","updated_at":"2025-03-30T07:17:31.649Z","avatar_url":"https://github.com/kianmeng.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Cpan license](https://img.shields.io/cpan/l/WebService-IPStack.svg)](https://metacpan.org/release/WebService-IPStack)\n[![Cpan version](https://img.shields.io/cpan/v/WebService-IPStack.svg)](https://metacpan.org/release/WebService-IPStack)\n\n# NAME\n\nWebService::IPStack - Perl library for IPStack's Geolocation API,\nhttps://ipstack.com.\n\n# SYNOPSIS\n\n    use WebService::IPStack;\n\n    my $ipstack = WebService::IPStack-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    $ipstack-\u003elookup('8.8.8.8');\n\n# DESCRIPTION\n\nWebService::IPStack is a Perl library for obtaining Geolocation information on\nIPv4 or IPv6 address.\n\n# DEVELOPMENT\n\nSource repo at [https://github.com/kianmeng/webservice-ipstack](https://github.com/kianmeng/webservice-ipstack).\n\nHow to contribute? Follow through the [CONTRIBUTING.md](https://github.com/kianmeng/webservice-ipstack/blob/master/CONTRIBUTING.md) document to setup your development environment.\n\n# METHODS\n\n## new($api\\_key, \\[$api\\_plan\\])\n\nConstruct a new WebService::IPStack instance.\n\n### api\\_key\n\nCompulsory. The API access key used to make request through web service.\n\n### api\\_plan\n\nOptional. The API subscription plan used when accessing the API. There are four\nsubscription plans: free, standard, pro, and pro\\_plus. The default subscription\nplan is 'free'. The main difference between free and non-free subscription\nplans are HTTPS encryption protocol support and additional information.\n\n    # The API request URL is http://api.ipstack.com/\n    my $ipstack = WebService::IPStack-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    print $ipstack-\u003eapi_url;\n\n    # The API request URL is https://api.ipstack.com/\n    my $ipstack = WebService::IPStack-\u003enew(\n        api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx32',\n        api_plan =\u003e 'standard'\n    );\n    print $ipstack-\u003eapi_url;\n\n### api\\_url\n\nThe default API hostname and path. The protocol depends on the subscription plan.\n\n## lookup($ip\\_address, \\[%params\\])\n\nQuery and get an IP address information. Optionally you can add more settings\nto adjust the output.\n\n    my $ipstack = WebService::IPStack-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    $ipstack-\u003elookup('8.8.8.8');\n\n    # With optional parameters.\n    $ipstack-\u003elookup('8.8.8.8', {hostname =\u003e 1, security =\u003e 1, output =\u003e 'xml'});\n\n## bulk\\_lookup($ip\\_address, \\[%params\\])\n\nOnly for paid subscription plans (standard, pro, or pro\\_plus).  Query and get\nmultiple IP addresses information. Optionally you can add more settings to\nadjust the output.\n\n    my $ipstack = WebService::IPStack-\u003enew(\n        api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32',\n        api_plan =\u003e 'standard'\n    );\n    $ipstack-\u003ebulk_lookup(['8.8.8.8', '8.8.4.4']);\n\n    # With optional parameters.\n    $ipstack-\u003ebulk_lookup(['8.8.8.8', '8.8.4.4'], {language =\u003e 'zh'});\n\n## check(\\[%params\\])\n\nLook up the IP address details of the client which made the web service call.\nOptionally you can add more settings to adjust the output.\n\n    my $ipstack = WebService::IPStack-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    $ipstack-\u003echeck();\n\n    # With optional parameters.\n    $ipstack-\u003echeck({hostname =\u003e 1, security =\u003e 1, output =\u003e xml});\n\n# AUTHOR\n\nKian Meng, Ang \u003ckianmeng@cpan.org\u003e\n\n# COPYRIGHT AND LICENSE\n\nThis software is Copyright (c) 2019 Kian Meng, Ang.\n\nThis is free software, licensed under:\n\n    The Artistic License 2.0 (GPL Compatible)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkianmeng%2Fwebservice-ipstack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkianmeng%2Fwebservice-ipstack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkianmeng%2Fwebservice-ipstack/lists"}