{"id":13540008,"url":"https://github.com/achillean/shodan-python","last_synced_at":"2025-05-12T15:36:17.197Z","repository":{"id":1059489,"uuid":"892815","full_name":"achillean/shodan-python","owner":"achillean","description":"The official Python library for Shodan","archived":false,"fork":false,"pushed_at":"2024-08-05T13:11:50.000Z","size":448,"stargazers_count":2600,"open_issues_count":47,"forks_count":588,"subscribers_count":134,"default_branch":"master","last_synced_at":"2025-04-23T17:19:35.161Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://developer.shodan.io","language":"Python","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/achillean.png","metadata":{"files":{"readme":"README.rst","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,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-09-07T04:09:46.000Z","updated_at":"2025-04-22T13:00:49.000Z","dependencies_parsed_at":"2023-10-15T02:30:23.510Z","dependency_job_id":"f1c87a10-547c-4d04-9b1e-b9009d935722","html_url":"https://github.com/achillean/shodan-python","commit_stats":{"total_commits":313,"total_committers":35,"mean_commits":8.942857142857143,"dds":"0.37060702875399365","last_synced_commit":"a08353e40b2018ec0dbf04012e9a5bfbe87f55ec"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achillean%2Fshodan-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/achillean","download_url":"https://codeload.github.com/achillean/shodan-python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250477820,"owners_count":21437049,"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":[],"created_at":"2024-08-01T09:01:37.302Z","updated_at":"2025-04-23T17:19:40.537Z","avatar_url":"https://github.com/achillean.png","language":"Python","readme":"shodan: The official Python library and CLI for Shodan\n======================================================\n\n.. image:: https://img.shields.io/pypi/v/shodan.svg\n    :target: https://pypi.org/project/shodan/\n\n.. image:: https://img.shields.io/github/contributors/achillean/shodan-python.svg\n    :target: https://github.com/achillean/shodan-python/graphs/contributors\n\nShodan is a search engine for Internet-connected devices. Google lets you search for websites,\nShodan lets you search for devices. This library provides developers easy access to all of the\ndata stored in Shodan in order to automate tasks and integrate into existing tools.\n\nFeatures\n--------\n\n- Search Shodan\n- `Fast/ bulk IP lookups \u003chttps://help.shodan.io/developer-fundamentals/looking-up-ip-info\u003e`_\n- Streaming API support for real-time consumption of Shodan firehose\n- `Network alerts (aka private firehose) \u003chttps://help.shodan.io/guides/how-to-monitor-network\u003e`_\n- `Manage Email Notifications \u003chttps://asciinema.org/a/7WvyDtNxn0YeNU70ozsxvXDmL\u003e`_\n- Exploit search API fully implemented\n- Bulk data downloads\n- Access the Shodan DNS DB to view domain information\n- `Command-line interface \u003chttps://cli.shodan.io\u003e`_\n\n.. image:: https://cli.shodan.io/img/shodan-cli-preview.png\n    :target: https://asciinema.org/~Shodan\n    :width: 400px\n    :align: center\n\n\nQuick Start\n-----------\n\n.. code-block:: python\n\n    from shodan import Shodan\n\n    api = Shodan('MY API KEY')\n\n    # Lookup an IP\n    ipinfo = api.host('8.8.8.8')\n    print(ipinfo)\n\n    # Search for websites that have been \"hacked\"\n    for banner in api.search_cursor('http.title:\"hacked by\"'):\n        print(banner)\n\n    # Get the total number of industrial control systems services on the Internet\n    ics_services = api.count('tag:ics')\n    print('Industrial Control Systems: {}'.format(ics_services['total']))\n\nGrab your API key from https://account.shodan.io\n\nInstallation\n------------\n\nTo install the Shodan library, simply:\n\n.. code-block:: bash\n\n    $ pip install shodan\n\nOr if you don't have pip installed (which you should seriously install):\n\n.. code-block:: bash\n\n    $ easy_install shodan\n\n\nDocumentation\n-------------\n\nDocumentation is available at https://shodan.readthedocs.org/ and https://help.shodan.io\n","funding_links":[],"categories":["\u003ca id=\"a76463feb91d09b3d024fae798b92be6\"\u003e\u003c/a\u003e侦察\u0026\u0026信息收集\u0026\u0026子域名发现与枚举\u0026\u0026OSINT","Python","others","Python Search Automation Tools","\u003ca id=\"170048b7d8668c50681c0ab1e92c679a\"\u003e\u003c/a\u003e工具"],"sub_categories":["\u003ca id=\"18c7c1df2e6ae5e9135dfa2e4eb1d4db\"\u003e\u003c/a\u003eShodan"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachillean%2Fshodan-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fachillean%2Fshodan-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachillean%2Fshodan-python/lists"}