{ "info": { "author": "IPFinder", "author_email": "mohamed@ipfinder.io", "bugtrack_url": null, "classifiers": [], "description": "IP Finder\n# IPFinder Python Client Library\n\nThe official Python 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\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 pip:\n```shell\npip install ipfinder-io\n```\n\n## How to Use\nusage is quite simple:\n\n## With `free` TOKEN\n\n```python\n\nimport ipfinder\n\nconfig = ipfinder.config() # emty token == free\n\n# lookup your IP address information\nauth = config.Authentication()\n\nauth.details\n```\n\n### Authentication\n\n```python\n\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n# lookup your IP address information\nauth = config.Authentication()\n\nauth.details\n```\n\n### Get IP address\n\n```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n# GET Get details for 1.0.0.0\n\nip = config.getAddressInfo('1.0.0.0')\n\nip.details\n\n# lookup IP address information\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```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n# lookup Asn information\nasn = config.getAsn('AS1')\n\nasn.details\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```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\nasn = 'as36947';\n\n# lookup Asn information\n\ndata = config.getFirewall(asn, 'nginx_deny')\n\ndata.details\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\n```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n# Organization name\norg = 'Telecom Algeria';\n\n# lookup Organization information\ndata = config.getRanges(org)\n\ndata.details\n\n\n\n```\n\n### Get service status\n\n```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n# lookup TOKEN information\ndata = config.getStatus()\n\n\ndata.details\n\n\n```\n\n### Get Domain IP\n\n\n```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n\n# domain name\nname = 'google.com';\n\ndata = config.getDomain(name)\n\ndata.details\n\n```\n\n### Get Domain IP history\n\n\n\n```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n# domain name\nname = 'google.com';\n\ndata = config.getDomainHistory(name)\n\ndata.details\n\n\n```\n\n### Get list Domain By ASN, Country,Ranges\n\n\n```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE')\n\n# list live domain by country DZ,US,TN,FR,MA\nby = 'DZ';\n\ndby = config.getDomainBy(by)\n\ndby.details\n\n\n```\n\n### Add proxy\n```python\nimport ipfinder\n\nconfig = ipfinder.config('YOUR_TOKEN_GOES_HERE','https://ipfinder.yourdomain.com')\n```\n\n### Error handling\n\n```python\nimport ipfinder\ntry:\n # do something\nexcept Exception as e:\n print('error: ', e)\n\n\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\u2019t available in our IP geolocation API developer documentation, simply [contact](https://ipfinder.io/contact) us at any time and we\u2019ll 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-python.svg)](https://github.com/ipfinder-io/ip-finder-python)\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ipfinder-io/ip-finder-python", "keywords": "ipfinder,IPV4,IPV6,ASN,Firewall,Domain", "license": "Apache License 2.0", "maintainer": "", "maintainer_email": "", "name": "ipfinder-io", "package_url": "https://pypi.org/project/ipfinder-io/", "platform": "any", "project_url": "https://pypi.org/project/ipfinder-io/", "project_urls": { "Homepage": "https://github.com/ipfinder-io/ip-finder-python", "Source": "https://github.com/ipfinder-io/ip-finder-python", "Tracker": "https://github.com/ipfinder-io/ip-finder-python/issues" }, "release_url": "https://pypi.org/project/ipfinder-io/1.0.0a1/", "requires_dist": [ "requests" ], "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*", "summary": "Official Python library for IPFinder", "version": "1.0.0a1" }, "last_serial": 5525485, "releases": { "1.0.0a1": [ { "comment_text": "", "digests": { "md5": "dde346cd24661ae2cec1773696b91cf7", "sha256": "ef7c36546420f1d49cc57df81c13fd013e1025ba20dccafe3ec1b6a6ff6c0df0" }, "downloads": -1, "filename": "ipfinder_io-1.0.0a1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "dde346cd24661ae2cec1773696b91cf7", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*", "size": 14694, "upload_time": "2019-07-12T23:33:03", "url": "https://files.pythonhosted.org/packages/49/30/4ecbfd04891da7de36c8e18fd6d1e13d5356b18c4fb37269e558c75997fb/ipfinder_io-1.0.0a1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "518fa9095ef3e45d9d1c9e328672e366", "sha256": "1a6e6e029e5e3fbbafe2434b03306bc5f931b06cb4ab0a7d184a0d89e9a78ef2" }, "downloads": -1, "filename": "ipfinder-io-1.0.0a1.tar.gz", "has_sig": false, "md5_digest": "518fa9095ef3e45d9d1c9e328672e366", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*", "size": 14128, "upload_time": "2019-07-12T23:33:05", "url": "https://files.pythonhosted.org/packages/1c/6e/f1d571208c8695ad1a07e8272b4b01e9e47b291376436d867e4762699de9/ipfinder-io-1.0.0a1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "dde346cd24661ae2cec1773696b91cf7", "sha256": "ef7c36546420f1d49cc57df81c13fd013e1025ba20dccafe3ec1b6a6ff6c0df0" }, "downloads": -1, "filename": "ipfinder_io-1.0.0a1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "dde346cd24661ae2cec1773696b91cf7", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*", "size": 14694, "upload_time": "2019-07-12T23:33:03", "url": "https://files.pythonhosted.org/packages/49/30/4ecbfd04891da7de36c8e18fd6d1e13d5356b18c4fb37269e558c75997fb/ipfinder_io-1.0.0a1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "518fa9095ef3e45d9d1c9e328672e366", "sha256": "1a6e6e029e5e3fbbafe2434b03306bc5f931b06cb4ab0a7d184a0d89e9a78ef2" }, "downloads": -1, "filename": "ipfinder-io-1.0.0a1.tar.gz", "has_sig": false, "md5_digest": "518fa9095ef3e45d9d1c9e328672e366", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*", "size": 14128, "upload_time": "2019-07-12T23:33:05", "url": "https://files.pythonhosted.org/packages/1c/6e/f1d571208c8695ad1a07e8272b4b01e9e47b291376436d867e4762699de9/ipfinder-io-1.0.0a1.tar.gz" } ] }