{"id":22752999,"url":"https://github.com/kianmeng/webservice-ipapi","last_synced_at":"2025-03-30T07:17:32.032Z","repository":{"id":56836244,"uuid":"165479645","full_name":"kianmeng/webservice-ipapi","owner":"kianmeng","description":"The Perl helper library for IP API, https://ipapi.com","archived":false,"fork":false,"pushed_at":"2019-04-29T13:39:42.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-05T09:26:41.970Z","etag":null,"topics":["api","cpan","geoip","ipv4","ipv6","perl"],"latest_commit_sha":null,"homepage":null,"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-13T07:50:13.000Z","updated_at":"2019-05-26T16:01:51.000Z","dependencies_parsed_at":"2022-08-20T12:31:18.219Z","dependency_job_id":null,"html_url":"https://github.com/kianmeng/webservice-ipapi","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-ipapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kianmeng%2Fwebservice-ipapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kianmeng%2Fwebservice-ipapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kianmeng%2Fwebservice-ipapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kianmeng","download_url":"https://codeload.github.com/kianmeng/webservice-ipapi/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","ipv4","ipv6","perl"],"created_at":"2024-12-11T06:08:29.592Z","updated_at":"2025-03-30T07:17:32.004Z","avatar_url":"https://github.com/kianmeng.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Cpan license](https://img.shields.io/cpan/l/WebService-IPAPI.svg)](https://metacpan.org/release/WebService-IPAPI)\n[![Cpan version](https://img.shields.io/cpan/v/WebService-IPAPI.svg)](https://metacpan.org/release/WebService-IPAPI)\n\n# NAME\n\nWebService::IPAPI - Perl library for IPAPI's Geolocation API,\nhttps://ipapi.com.\n\n# SYNOPSIS\n\n    use WebService::IPAPI;\n\n    my $ipapi = WebService::IPAPI-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    $ipapi-\u003equery('8.8.8.8');\n\n    # Only for Pro plan.\n    $ipapi-\u003equery(['8.8.8.8', '8.8.4.4']);\n\n# DESCRIPTION\n\nWebService::IPAPI is a Perl library for obtaining information on IPv4 or IPv6\naddress.\n\n# DEVELOPMENT\n\nSource repository at [https://github.com/kianmeng/webservice-ipapi](https://github.com/kianmeng/webservice-ipapi).\n\nHow to contribute? Follow through the [CONTRIBUTING.md](https://github.com/kianmeng/webservice-ipapi/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::IPAPI 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, business, and business\\_pro. The\nsubscription plan is 'free'. The main difference between free and non-free\nsubscription plans are HTTPS encryption protocol support and additional\ninformation.\n\n    # The API request URL is http://api.ipapi.com/api/\n    my $ipapi = WebService::IPAPI-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    print $ipapi-\u003eapi_url;\n\n    # The API request URL is https://api.ipapi.com/api/\n    my $ipapi = WebService::IPAPI-\u003enew(\n        api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx32',\n        api_plan =\u003e 'standard'\n    );\n    print $ipapi-\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 $ipapi = WebService::IPAPI-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    $ipapi-\u003equery('8.8.8.8');\n\n    # With optional parameters.\n    $ipapi-\u003equery('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, business, business\\_pro). Query and\nget multiple IP addresses information. Optionally you can add more settings to\nadjust the output.\n\n    my $ipapi = WebService::IPAPI-\u003enew(\n        api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32',\n        api_plan =\u003e 'standard'\n    );\n    $ipapi-\u003equery(['8.8.8.8', '8.8.4.4']);\n\n    # With optional parameters.\n    $ipapi-\u003equery(['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 $ipapi = WebService::IPAPI-\u003enew(api_key =\u003e '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');\n    $ipapi-\u003echeck();\n\n    # With optional parameters.\n    $ipapi-\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-ipapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkianmeng%2Fwebservice-ipapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkianmeng%2Fwebservice-ipapi/lists"}