---
id: cloudcheck
version: "11.1.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# cloudcheck — Detailed database of cloud providers. Instantly look up a domain or IP address

License: unclear · Maintenance: active · Downloads: 94.4K/mo

## What it is and what it does

CloudCheck is a Python library (with Rust bindings) that determines whether a given IP address or hostname belongs to a cloud provider. It maintains a database of cloud provider signatures—domains, CIDR ranges, and ASNs—that is updated daily via CI/CD pipelines. The library fetches domain data from the v2fly community repository and CIDR data from ASNDB, covering 60 cloud providers including major players like AWS, Google Cloud, Azure, and regional providers. It exposes both an async Python API and a REST server interface.

The package is designed for security and reconnaissance workflows, particularly within the BBOT reconnaissance framework ecosystem. It handles IP and hostname lookups asynchronously, supports custom signature sources and retry configuration, and provides structured output identifying the cloud provider and associated metadata (name, tags, descriptions). The library requires Python 3.10+ and has no external runtime dependencies, making it straightforward to integrate into existing Python applications.

Use it for:

- Identify cloud infrastructure during security reconnaissance or penetration testing to filter out cloud-hosted targets
- Validate whether discovered IPs or domains belong to known cloud providers in automated scanning workflows
- Build a REST API service to expose cloud provider lookups to other tools or teams via HTTP
- Enrich security logs or threat intelligence feeds by tagging IPs/domains with their cloud provider affiliation

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Identifies whether an IP address or hostname belongs to a cloud provider by querying a daily-updated database of cloud provider signatures, domains, and CIDR ranges.

Yes, if you need reliable cloud provider identification. The package is actively maintained, has no security vulnerabilities, covers 60 providers with daily-updated signatures, and integrates cleanly into Python workflows. The async API and optional REST server make it flexible for both library and service use cases. Install friction is moderate but manageable for modern Python environments (3.10+).

## Install

pip install cloudcheck
uv add cloudcheck
poetry add cloudcheck

## Installing cloudcheck

Before you install: Medium install friction due to compiled wheels across multiple architectures and Python versions (cp310, cp311). Package is actively maintained with recent commits and no known vulnerabilities.

Quickstart:

pip install cloudcheck

import asyncio
from cloudcheck import CloudCheck

async def main():
    cloudcheck = CloudCheck()
    results = await cloudcheck.lookup("8.8.8.8")
    print(results)

asyncio.run(main())

Requires Python 3.10 or later; async/await pattern requires asyncio event loop.

Verify before relying:

- Whether the daily-updated signatures are automatically fetched on first use or require manual refresh
- Performance characteristics for bulk lookups or high-frequency queries
- Accuracy and coverage of the cloud provider database across all major providers

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 94.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cloud provider IP lookup, detect cloud infrastructure, identify cloud provider from IP, cloud provider database, IP address cloud detection, cloud-detection, security-reconnaissance, ip-lookup

[View on SkillFed](https://skillfed.io/packages/cloudcheck) · [View on PyPI](https://pypi.org/project/cloudcheck/)