Skip to content

A Python utility for effective extraction and analysis of internet data through Censys.

License

Notifications You must be signed in to change notification settings

franckferman/Censys-API-Python

Repository files navigation

Contributors Stargazers License

banner-Censys-API-Python

Censys-API-Python

A Python utility for Censys API to extract IP addresses, services, and banners efficiently.

πŸ“œ Table of Contents

Click to collapse/expand
  1. πŸ“– About
  2. πŸ“œ License
  3. πŸ“ž Contact

πŸ“– About

Censys-API-Python is a simple Python utility designed to extract public data from the Censys API, including IP addresses, services, banners, certificates, operating system CPEs, and ASN information associated with a domain.

This is primarily a personal/professional tool, built to address a very specific need I had β€” being able to quickly fetch and view basic data from Censys without relying on heavy or overly complex solutions.

βš™οΈ This script is not optimized for performance or large-scale automation. It’s a straightforward and functional tool for precise, targeted use cases.

βœ… Key Features:

  • Fast extraction of IP addresses, services, banners, certificates.
  • Console output or HTML export.
  • Handles virtual hosts inclusion/exclusion.
  • Option to display only IP addresses (--ip_only).
  • Basic pagination (up to 100 results per query).
  • Simple CLI usage.

πŸ’‘ Why share it? Because it might help someone else, and I believe in sharing useful tools β€” even if they're not perfect. If this can save you time, feel free to use, adapt, or improve it. And if you have suggestions or contributions, they are welcome!

(back to top)

πŸ“œ License

This project is licensed under the GNU Affero General Public License, Version 3.0. For more details, please refer to the LICENSE file in the repository: Read the license on GitHub

(back to top)

πŸ“ž Contact

ProtonMail LinkedIn

(back to top)