API Reference

Integrate Azazel OSINT intelligence directly into your security stack. Our REST API provides programmatic access to 14B+ records with institutional-grade reliability.

Authentication

Azazel API uses Bearer token authentication. Your API keys are institutional credentials and should be handled with absolute security. Never expose keys in client-side code.

Security Note

Premium keys support CIDR allowlisting and granular endpoint permissions.

Header Example
Authorization: Bearer az_live_...

Search Endpoints

POST/api/v1/search

Perform a global intelligence search across all providers.

Parameters

querystring

The value to search for (email, IP, etc.)

typestring

The search type (EMAIL, IP, USERNAME, AUTO)

import requests

API_KEY = "az_live_..."
url = "https://azazel-osint.com/api/v1/search"

payload = {
    "query": "john.doe@example.com",
    "type": "EMAIL"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
GET/api/v1/status

Check system health and provider availability.

import requests

API_KEY = "az_live_..."
url = "https://azazel-osint.com/api/v1/search"

payload = {
    "query": "john.doe@example.com",
    "type": "EMAIL"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
GET/api/v1/me

Retrieve current authenticated user profile and subscription stats.

import requests

API_KEY = "az_live_..."
url = "https://azazel-osint.com/api/v1/search"

payload = {
    "query": "john.doe@example.com",
    "type": "EMAIL"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())