{"id":13447366,"url":"https://github.com/ipfinder-io/ip-finder-node","last_synced_at":"2026-01-12T08:27:25.625Z","repository":{"id":35021047,"uuid":"197210400","full_name":"ipfinder-io/ip-finder-node","owner":"ipfinder-io","description":"Official Node.js client library for IPfinder","archived":false,"fork":false,"pushed_at":"2023-01-07T07:50:42.000Z","size":1108,"stargazers_count":7,"open_issues_count":17,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-28T11:46:42.963Z","etag":null,"topics":["asn","country","enterprise","firewall","geoip","geojson","geolocation","ipfinder","ipv4","ipv6","ranges"],"latest_commit_sha":null,"homepage":"https://ipfinder.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ipfinder-io.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-07-16T14:31:47.000Z","updated_at":"2023-05-12T16:55:33.000Z","dependencies_parsed_at":"2023-01-15T12:10:35.487Z","dependency_job_id":null,"html_url":"https://github.com/ipfinder-io/ip-finder-node","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipfinder-io%2Fip-finder-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipfinder-io%2Fip-finder-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipfinder-io%2Fip-finder-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipfinder-io%2Fip-finder-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ipfinder-io","download_url":"https://codeload.github.com/ipfinder-io/ip-finder-node/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244838162,"owners_count":20518798,"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":["asn","country","enterprise","firewall","geoip","geojson","geolocation","ipfinder","ipv4","ipv6","ranges"],"created_at":"2024-07-31T05:01:15.562Z","updated_at":"2026-01-12T08:27:25.620Z","avatar_url":"https://github.com/ipfinder-io.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cimg src='https://camo.githubusercontent.com/46886c3e689a0d4a3f6c0733d1cab5d9f9a3926d/68747470733a2f2f697066696e6465722e696f2f6173736574732f696d616765732f6c6f676f732f6c6f676f2e706e67' height='60' alt='IP Finder'\u003e\u003c/a\u003e\n#  IPFinder Node.js Client Library\n[![npm version](https://badge.fury.io/js/ipfinder.svg)](https://badge.fury.io/js/ipfinder)\n\nThe official Node.js client library for the [IPFinder.io](https://ipfinder.io) get details for :\n-  IP address details (city, region, country, postal code, latitude and more ..)\n-  ASN details (Organization name, registry,domain,comany_type, and more .. )\n-  Firewall by supported formats details (apache_allow,  nginx_deny, CIDR , and more ..)\n-  IP Address Ranges by the Organization name  details (list_asn, list_prefixes , and more ..)\n-  service status details (queriesPerDay, queriesLeft, key_type, key_info)\n- Get Domain IP (asn, organization,country_code ....)\n- Get Domain IP history (total_ip, list_ip,organization,asn ....)\n- Get list Domain By ASN, Country,Ranges (select_by , total_domain  , list_domain ....)\n\n## Getting Started\nsingup for a free account at [https://ipfinder.io/auth/signup](https://ipfinder.io/auth/signup), for Free IPFinder API access token.\n\nThe free plan is limited to 4,000 requests a day, and doesn't include some of the data fields\nTo enable all the data fields and additional request volumes see [https://ipfinder.io/pricing](https://ipfinder.io/pricing).\n\n## Documentation\n\nSee the [official documentation](https://ipfinder.io/docs).\n\n## Installation\nInstalling using npm or yarn:\n```shell\nnpm install ipfinder\n# or\nyarn add ipfinder\n```\n\n## With `free` TOKEN\n\n```javascript\n\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder(); //  emty token == free\n\n// lookup your IP address information\nipfinder.Authentication().then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n```\n\n## Authentication\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n\n// lookup your IP address information\nipfinder.Authentication().then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n\n```\n\n## Get IP address\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n\n// GET Get details for 1.0.0.0\nvar ip_address = '1.0.0.0';\n\n// lookup IP address information\n\nipfinder.getAddressInfo(\"1.0.0.0\").then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n\n```\n\n## Get ASN\nThis API available as part of our Pro and enterprise [https://ipfinder.io/pricing](https://ipfinder.io/pricing).\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n\nvar asn = 'as36947';\n\n// lookup Asn information\nipfinder.getAsn(\"as1\").then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n```\n\n## Firewall\nThis API available as part of our  enterprise [https://ipfinder.io/pricing](https://ipfinder.io/pricing).\nformats 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`\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n\nvar asn = 'as36947';\n\n// lookup Asn Firewall information\nipfinder.getFirewall(\"AS1\", 'nginx_deny').then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n\n```\n\n## Get IP Address Ranges\nThis API available as part of our  enterprise [https://ipfinder.io/pricing](https://ipfinder.io/pricing).\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n\n// Organization name\nvar org = 'Telecom Algeria';\n\n// lookup Organization information\nipfinder.getRanges(\"Telecom Algeria\").then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n\n\n```\n\n## Get service status\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n\n// lookup IP TOKEN information\n\nipfinder.getStatus().then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n\n```\n\n## Get Domain IP\n\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n// domain name\nipfinder.getDomain(\"google.com\").then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n```\n\n## Get Domain IP history\n\n\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n// domain name IP history\nipfinder.getDomainHistory(\"google.com\").then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n\n```\n\n## Get list Domain By ASN, Country,Ranges\n\n\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE');\n// list live domain by country DZ,US,TN,FR,MA\nipfinder.getDomainBy(\"DZ\").then(data =\u003e {\n     console.log(data);\n    // console.log(data.status_message);\n}).catch(console.log);\n\n```\n\n## Add proxy\n```javascript\nconst Ipfinder = require('ipfinder');\nconst ipfinder = new Ipfinder('YOUR_TOKEN_GOES_HERE', 'https://ipfinder.yourdomain.com');\n```\n\nSample codes under **examples/** folder.\n\n\n## Contact\n\nContact 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](https://ipfinder.io/contact) us at any time and we’ll be able to help you find what you need.\n\n## License\n----\n\n[![GitHub license](https://img.shields.io/github/license/ipfinder-io/ip-finder-node.svg)](https://github.com/ipfinder-io/ip-finder-node)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipfinder-io%2Fip-finder-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipfinder-io%2Fip-finder-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipfinder-io%2Fip-finder-node/lists"}