{"id":13529968,"url":"https://github.com/censys/censys-python","last_synced_at":"2025-05-14T04:08:29.001Z","repository":{"id":37493104,"uuid":"43082714","full_name":"censys/censys-python","owner":"censys","description":"An easy-to-use and lightweight API wrapper for Censys APIs.","archived":false,"fork":false,"pushed_at":"2025-04-03T12:17:33.000Z","size":2488,"stargazers_count":430,"open_issues_count":7,"forks_count":97,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-04-12T16:44:01.097Z","etag":null,"topics":["api","attack-surface-management","censys","hacktoberfest","pypi","python","python3","search"],"latest_commit_sha":null,"homepage":"https://censys-python.rtfd.io/","language":"Python","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/censys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-09-24T17:41:20.000Z","updated_at":"2025-03-24T18:02:32.000Z","dependencies_parsed_at":"2023-02-17T05:45:26.424Z","dependency_job_id":"e12c84b3-ddd6-4ddd-8286-c8418eaa1719","html_url":"https://github.com/censys/censys-python","commit_stats":{"total_commits":926,"total_committers":27,"mean_commits":34.2962962962963,"dds":0.4535637149028078,"last_synced_commit":"8f95e6c2d4ed5a95be8b7cef46a292a9d42995e9"},"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/censys","download_url":"https://codeload.github.com/censys/censys-python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254069768,"owners_count":22009558,"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","attack-surface-management","censys","hacktoberfest","pypi","python","python3","search"],"created_at":"2024-08-01T07:00:41.431Z","updated_at":"2025-05-14T04:08:23.986Z","avatar_url":"https://github.com/censys.png","language":"Python","readme":"# Censys Python Library\n\n[![PyPI](https://img.shields.io/pypi/v/censys?color=orange\u0026logo=pypi\u0026logoColor=orange)](https://pypi.org/project/censys/)\n[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://www.python.org/downloads/)\n[![Read the Docs (version)](https://img.shields.io/readthedocs/censys-python/latest?logo=read%20the%20docs)](https://censys-python.readthedocs.io/en/stable/?badge=stable)\n[![GitHub Discussions](https://img.shields.io/badge/GitHub-Discussions-brightgreen?logo=github)](https://github.com/censys/censys-python/discussions)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-organge.svg?logo=git\u0026logoColor=organge)](http://makeapullrequest.com)\n[![License](https://img.shields.io/github/license/censys/censys-python?logo=apache)](https://github.com/censys/censys-python/blob/main/LICENSE)\n\nAn easy-to-use and lightweight API wrapper for Censys APIs ([censys.io](https://censys.io/)). Python 3.8+ is currently supported. This library has been tested on Python 3.8 and 3.x (Currently version 3.10).\n\n\u003e **Notice:** The Censys Search v1 endpoints are deprecated as of Nov. 30, 2021. Please begin using v2 endpoints to query hosts and certificates and check out our [support center](https://support.censys.io/hc/en-us/sections/360013076551-Censys-Search-2-0) for resources.\n\n\u003e [!IMPORTANT]\n\u003e This library does not support the new Censys Platform, however a new set of SDKs that do support the platform are coming soon.\n\u003e Please refer to the [platform API refrence docs](https://docs.censys.com/reference/get-started#/) in the mean time.\n\n## Features\n\n- [Search Censys data](https://censys-python.readthedocs.io/en/stable/usage-v2.html)\n- [Bulk Certificate lookups](https://censys-python.readthedocs.io/en/stable/usage-v2.html#bulk-view)\n- [Download Bulk Data](https://censys-python.readthedocs.io/en/stable/usage-v1.html#data)\n- [Manage assets, events, and seeds in Censys ASM](https://censys-python.readthedocs.io/en/stable/usage-asm.html)\n- [Command-line interface](https://censys-python.readthedocs.io/en/stable/cli.html)\n\n\u003c!-- markdownlint-disable MD033 --\u003e\n\n\u003ca href=\"https://asciinema.org/a/500416\" target=\"_blank\"\u003e\u003cimg src=\"https://asciinema.org/a/500416.svg\" width=\"600\"/\u003e\u003c/a\u003e\n\n\u003c!-- markdownlint-enable MD033 --\u003e\n\n## Getting Started\n\nThe library can be installed using `pip`.\n\n```sh\npip install censys\n```\n\nTo upgraded using `pip`.\n\n```sh\npip install --upgrade censys\n```\n\nAlternatively, you can install the library using `poetry`.\n\n```sh\ngit clone https://github.com/censys/censys-python.git\ncd censys-python/\npoetry install\n```\n\nOptionally, you can enable tab completion for the CLI by adding this line to your `~/.bashrc`, `~/.zshrc`, or equivalent.\n\n\u003e Please note that autocomplete is supported for field names in the `search` command.\n\n```sh\neval \"$(register-python-argcomplete censys)\"\n```\n\nTo configure your search credentials run `censys config` or set both `CENSYS_API_ID` and `CENSYS_API_SECRET` environment variables.\n\n```sh\n$ censys config\n\nCensys API ID: XXX\nCensys API Secret: XXX\nDo you want color output? [y/n]: y\n\nSuccessfully authenticated for your@email.com\n```\n\nIf you have a Censys ASM account, you can configure your ASM credentials by running `censys asm config` or set both `CENSYS_ASM_API_KEY` environment variables.\n\n```sh\n$ censys asm config\n\nCensys ASM API Key: XXX\nDo you want color output? [y/n]: y\n\nSuccessfully authenticated\n```\n\n## Examples\n\nThe examples located in the [`examples/`](examples/) directory are a great place to start. You can also find more examples in the [usage documentation](https://censys-python.readthedocs.io/en/stable/usage-v2.html).\n\n## [Documentation](https://censys-python.readthedocs.io/)\n\n[![Read the Docs](https://raw.githubusercontent.com/censys/censys-python/main/docs/_static/readthedocs.png)](https://censys-python.readthedocs.io/)\n\n## Resources\n\n- [Source](https://github.com/censys/censys-python)\n- [Issue Tracker](https://github.com/censys/censys-python/issues)\n- [Changelog](https://github.com/censys/censys-python/releases)\n- [Documentation](https://censys-python.rtfd.io)\n- [Discussions](https://github.com/censys/censys-python/discussions)\n- [Censys Homepage](https://censys.io/)\n- [Censys Search](https://search.censys.io/)\n\n## Contributing\n\nAll contributions (no matter how small) are always welcome. See [Contributing to Censys Python](.github/CONTRIBUTING.md)\n\n## Development\n\nThis project uses [poetry](https://python-poetry.org/) for dependency management. Please ensure you have [installed the latest version](https://python-poetry.org/docs/#installation).\n\n```sh\ngit clone git@github.com:censys/censys-python.git\ncd censys-python/\npoetry install\n```\n\n## Testing\n\n```sh\n# Run tests\npoetry run pytest\n# With coverage report\npoetry run pytest --cov-report html\n```\n\n## License\n\nThis software is licensed under [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\n- Copyright (C) 2024 Censys, Inc.\n","funding_links":[],"categories":["Automation","Python Search Automation Tools","自动化工具","Automation and Convention"],"sub_categories":["Code libraries and bindings","代码库和绑定"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensys%2Fcensys-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcensys%2Fcensys-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensys%2Fcensys-python/lists"}