Public APIs

Censys

Security

Search engine for Internet connected host and devices

Visit API

📚 Documentation & Examples

Everything you need to integrate with Censys

🚀 Quick Start Examples

Censys Javascript Examplejavascript

// Censys API Example
const response = await fetch('https://search.censys.io/api', {
    method: 'GET',
    headers: {
        'Content-Type': 'application/json'
    }
});

const data = await response.json();
console.log(data);

Censys API serves as a powerful search engine specifically designed to discover internet-connected hosts and devices, providing users with insights and visibility into the global landscape of the Internet. With its comprehensive database, Censys helps security professionals, researchers, and developers identify vulnerabilities, track assets, and understand the exposure of their networked devices. By leveraging the robustness of Censys, users can conduct complex queries to obtain real-time data about devices, SSL certificates, and services around the world, making it an indispensable tool for enhancing cybersecurity strategies and network management.

Benefits of using the Censys API include:

Access to a vast database of internet-connected hosts and devices.
Enhanced security posture through vulnerability identification and management.
Up-to-date information that allows for real-time asset tracking.
Customizable queries to tailor search results to specific needs.
A straightforward API that integrates easily with existing applications.

Here’s an example of how to call the Censys API using JavaScript:

const axios = require('axios');

const CENSYS_API_ID = 'your_api_id';
const CENSYS_API_SECRET = 'your_api_secret';
const CENSYS_URL = 'https://search.censys.io/api/v2/hosts';

const searchCensys = async (query) => {
    try {
        const response = await axios.get(CENSYS_URL, {
            auth: {
                username: CENSYS_API_ID,
                password: CENSYS_API_SECRET
            },
            params: {
                query: query
            }
        });
        console.log(response.data);
    } catch (error) {
        console.error('Error searching Censys:', error);
    }
};

searchCensys('services.port: 443');