API Documentation

Complete reference for the OSINTDog Professional Intelligence API v2.0

API Status: Operational

Introduction

The OSINTDog API provides professional-grade access to 15+ intelligence sources through a unified interface. Our API aggregates data from multiple trusted third-party services, enabling comprehensive OSINT investigations through a single endpoint.

Base URL

https://osintdog.com

Legal Compliance: Before using our API, ensure your intended use complies with data protection laws and regulations in your jurisdiction, including GDPR, CCPA, and other applicable privacy laws. This service is intended for legitimate security research, threat intelligence, and authorized investigations only.

Authentication

All API requests require authentication using an API key passed in the request header.

Header Format

Request Headers
X-API-Key: your_api_key_here
Content-Type: application/json

Getting an API Key

Purchase an API key from our main website. We offer both monthly (€7/month) and lifetime (€50 one-time) plans.

Quick Start

Make Your First Request

Here's how to perform a universal search across all data sources:

cURL Example
curl -X POST "https://osintdog.com/api/search" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "field": [{"email": "[email protected]"}]
  }'
Python Example
import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

data = {
    "field": [{"email": "[email protected]"}]
}

response = requests.post(
    'https://osintdog.com/api/search',
    headers=headers,
    json=data
)

print(response.json())

Rate Limits

Rate limits vary based on your subscription plan:

Plan Hourly Limit Daily Limit Queries
Monthly No limit No limit Unlimited
Lifetime No limit No limit Unlimited

Universal Search

Search across three core intelligence services with a single request. Due to increased usage of our free services, this endpoint now queries only the primary intelligence sources (IntelVault, LeakCheck, Snusbase) for optimal performance and resource management. For access to all 15+ services, use individual service endpoints.

POST /api/search

Request Body

{
  "field": [
    {"email": "[email protected]"}
    // or {"username": "targetuser"}
    // or {"phone": "+1234567890"}
    // or {"domain": "example.com"}
    // or {"ip": "192.168.1.1"}
  ]
}

Supported Search Types

Search Type Description Services Used Example
email Email address search IntelVault, LeakCheck, Snusbase [email protected]
username Username search IntelVault, LeakCheck, Snusbase johndoe123
phone Phone number search IntelVault, LeakCheck, Snusbase +1234567890
domain Domain investigation IntelVault, LeakCheck, Snusbase example.com
ip IP address analysis IntelVault, LeakCheck, Snusbase 192.168.1.1

Response Example

200 OK
{
  "success": true,
  "credit": "Lookup made by https://osintdog.com",
  "search_term": "[email protected]",
  "search_type": "email",
  "results": {
    "intelvault": { ... },
    "leakcheck": { ... },
    "snusbase": { ... }
  }
}

API Status

Check the operational status of all services.

GET /api/status

Response Example

{
  "status": "online",
  "version": "2.0.0",
  "services": {
    "data_breach": [
      "Database", "IntelVault", "LeakCheck v2", "Snusbase", 
      "BreachBase (Proxy)", "HackCheck", 
      "OathNet Breach Search", "INF0SEC Leaks"
    ],
    "social_media": [
      "SEON Email", "SEON Phone", "OathNet Holehe", 
      "OathNet GHunt", "INF0SEC Discord"
    ]
  }
}

Database

Advanced database search with support for multiple data types and wildcard searches.

POST /api/database

Request Body

{
  "query": "[email protected]",
  "searchType": "email",
  "wildcard": false
}

Supported Search Types

Search Type Description Example
email Email address search [email protected]
password Password search plaintextpassword
url URL search https://example.com
username Username search johndoe123
discord_id Discord ID search 123456789012345678
uuid UUID search 550e8400-e29b-41d4-a716-446655440000

Parameters

Parameter Type Required Description
query string Yes Search term
searchType string No Type of search (default: "email")
wildcard boolean No Enable wildcard search (default: false)

Example Requests

Email Search
curl -X POST "https://osintdog.com/api/database" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "[email protected]",
    "searchType": "email",
    "wildcard": false
  }'
Wildcard Username Search
curl -X POST "https://osintdog.com/api/database" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "john*",
    "searchType": "username",
    "wildcard": true
  }'

Response Example

200 OK
{
  "success": true,
  "credit": "Lookup made by https://osintdog.com",
  "service": "Database",
  "results": {
    "data": [...],
    "status": "success",
    "total_results": 42
  }
}

Wildcard Searches: Enable wildcard searching with the wildcard: true parameter. Use * for multiple characters and ? for single character matching.

Snusbase

Comprehensive database search with advanced filtering.

POST /api/snusbase/search

Request Body

{
  "terms": ["[email protected]"],
  "types": ["email"],
  "wildcard": false,
  "group_by": "db",
  "tables": null
}

Additional Snusbase Endpoints

Endpoint Method Description
/api/snusbase/stats GET Database statistics
/api/snusbase/ip-whois POST IP WHOIS lookup
/api/snusbase/hash-lookup POST Hash cracking service

LeakCheck v2

Advanced search with pagination and filtering options.

POST /api/leakcheck/v2

Request Body

{
  "term": "[email protected]",
  "search_type": "email",
  "limit": 1000,
  "offset": 0
}

Search Types: email, username, phone, domain, ip, auto, hash

HackCheck

HackCheck database search for comprehensive breach data.

POST /api/hackcheck

Request Body

{
  "term": "[email protected]",
  "search_type": "email"
}

Search Types: email, username, lastip

BreachBase

BreachBase database search via proxy service.

POST /api/breachbase

Request Body

{
  "term": "[email protected]",
  "search_type": "email"
}

Search Types: email, username, lastip

IntelVault

Access IntelVault's comprehensive breach database for targeted searches.

POST /api/intelvault

Request Body

{
  "field": [
    {"email": "[email protected]"}
  ]
}

OathNet Services

Comprehensive social media and gaming platform OSINT.

Search Sessions

POST /api/oathnet/search/init

Initialize a search session for multi-step investigations.

Request Body

{
  "query": "investigation_target"
}

Gaming Platform Lookups

Endpoint Platform Parameters
/api/oathnet/roblox-userinfo Roblox username or user_id
/api/oathnet/discord-to-roblox Discord → Roblox discord_id
/api/oathnet/steam-userinfo Steam steam_id
/api/oathnet/xbox-userinfo Xbox xbl_id
/api/oathnet/minecraft-history Minecraft username

Email Intelligence

Endpoint Description
/api/oathnet/holehe Check email registration on 120+ platforms
/api/oathnet/ghunt Google account lookup and analysis

INF0SEC

Multi-module intelligence platform with specialized search capabilities.

INF0SEC Modules: INF0SEC uses a modular approach where each endpoint represents a specialized search capability. All endpoints follow the same pattern: /api/inf0sec/{module}?q={query}

Endpoint Module Description
/api/inf0sec/leaks Leaks General data breach search
/api/inf0sec/discord Discord Discord-specific data including users, servers, tokens
/api/inf0sec/npd NPD National Public Data search with multiple criteria
/api/inf0sec/domain Domain Domain intelligence and WHOIS data
/api/inf0sec/username Username Username analysis across multiple platforms
/api/inf0sec/hlr HLR Phone number lookup and carrier information
/api/inf0sec/cfx CFX CFX gaming platform data (FiveM/RedM)

NPD Search Example

GET /api/inf0sec/npd

Query Parameters

?firstname=John&lastname=Doe&phone=1234567890&city=NewYork

Available Parameters: firstname, middlename, lastname, dob, phone, address, city, zip_code, ssn

Legal Notice: Public records searches must comply with applicable laws and regulations. Ensure you have proper authorization before accessing personal information.

Discord Module Example

GET /api/inf0sec/discord

Example Searches

# Search by Discord username
GET /api/inf0sec/discord?q=username123

# Search by Discord ID  
GET /api/inf0sec/discord?q=123456789012345678

# Search by email
GET /api/inf0sec/[email protected]

Discord Data Types: User IDs, usernames, email addresses, phone numbers, tokens, server data

SEON

Email and phone number intelligence with digital footprint analysis.

Endpoint Method Description
/api/seon/email GET Email analysis and verification
/api/seon/phone GET Phone number analysis
GET /api/seon/email

Query Parameters

GET /api/seon/[email protected]

SEON Email Returns: Social media profiles, account registrations, reputation scores, risk indicators, and digital behavior patterns.

Rutify (Chilean Intelligence)

Specialized Chilean data intelligence platform for RUT, name, vehicle, and SII searches.

Regional Focus: Rutify specializes in Chilean public records and business intelligence. All searches are specific to Chilean data sources.

RUT Search

POST /api/rutify/rut

Request Body

{
  "rut": "12345678-9"
}

Description: Search Chilean RUT (Rol Único Tributario) for personal and business information.

Name Search

POST /api/rutify/name

Request Body

{
  "name": "Juan Pérez González"
}

Description: Search by full name to find associated RUT and personal information.

Vehicle Search

POST /api/rutify/car

Request Body

{
  "plate": "ABCD12"
}

Description: Search Chilean vehicle registration by license plate number.

SII Search

POST /api/rutify/sii

Request Body

{
  "rut": "12345678-9"
}

Description: Search Chilean tax authority (SII) records for business and tax information.

Legal Notice: Rutify searches access Chilean public records. Ensure compliance with Chilean data protection laws and use only for legitimate purposes.

Akula Database

Comprehensive breach database search with support for multiple data types.

POST /api/akula

Request Body

{
  "searchTerm": "[email protected]",
  "search_type": "email"
}

Supported Search Types

Search Type Description Example
email Email address search [email protected]
username Username search johndoe123
domain Domain-based search example.com

Response Example

200 OK
{
  "success": true,
  "credit": "Lookup made by https://osintdog.com",
  "service": "Akula",
  "search_term": "[email protected]",
  "search_type": "email",
  "results": {
    "data": [...],
    "status": "success"
  }
}

LeakSight Platform

Advanced intelligence platform with comprehensive search capabilities across multiple data types.

POST /api/leaksight

Request Body

{
  "term": "[email protected]",
  "search_type": "email"
}

Supported Search Types

Search Type Description Example
email Email address search [email protected]
username Username search johndoe123
phone Phone number search +1234567890
domain Domain analysis example.com
ip IP address search 192.168.1.1

Example Requests

Email Search
curl -X POST "https://osintdog.com/api/leaksight" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "term": "[email protected]",
    "search_type": "email"
  }'
IP Geolocation
curl -X POST "https://osintdog.com/api/leaksight" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "term": "8.8.8.8",
    "search_type": "ipgeo"
  }'

Multi-Purpose Platform: LeakSight offers comprehensive search capabilities with multiple data types, making it ideal for complex investigations requiring multiple data points.

Room 101 (Reddit Analysis)

Advanced Reddit user analysis and intelligence platform with AI-powered insights.

AI-Powered Analysis: Room 101 uses advanced AI models to analyze Reddit user behavior, comment patterns, and provide psychological insights for investigative purposes.

User Analysis

GET /api/room101/analyze/{username}

Query Parameters

Parameter Type Description Default
model string AI model to use for analysis default
latest boolean Get only latest data false
refresh boolean Force refresh cached data false
sources boolean Include source information false
use_case string Specific use case for analysis null

Example Request

Comprehensive User Analysis
curl -X GET "https://osintdog.com/api/room101/analyze/spez?model=gpt-4&latest=true&sources=true&use_case=investigation" \
  -H "X-API-Key: your_api_key_here"

User Comment History

GET /api/room101/user/{username}

Query Parameters

GET /api/room101/user/spez?latest=true

Description: Retrieve complete comment and post history for a Reddit user.

Subreddit User Analysis

GET /api/room101/subreddit/{subreddit_name}

Example Request

GET /api/room101/subreddit/AskReddit

Description: Get active users and behavioral patterns within a specific subreddit.

Content Search

GET /api/room101/search

Query Parameters

GET /api/room101/search?terms=python&terms=programming&terms=security

Description: Search Reddit submissions and comments by multiple terms.

API Quota Check

GET /api/room101/quota

Description: Check remaining API quota and usage statistics.

Response Example

200 OK
{
  "success": true,
  "credit": "Lookup made by https://osintdog.com",
  "service": "Room 101 Quota",
  "results": {
    "remaining_requests": 450,
    "total_requests": 500,
    "reset_date": "2024-02-01T00:00:00Z"
  }
}

Complete Example Workflow

Python Investigation Script
import requests

headers = {"X-API-Key": "your_api_key_here"}
base_url = "https://osintdog.com"

# 1. Check API quota
quota = requests.get(f"{base_url}/api/room101/quota", headers=headers)
print("Quota:", quota.json())

# 2. Analyze user with AI
analysis = requests.get(
    f"{base_url}/api/room101/analyze/target_user?model=gpt-4&sources=true", 
    headers=headers
)
print("AI Analysis:", analysis.json())

# 3. Get user history
history = requests.get(
    f"{base_url}/api/room101/user/target_user?latest=true", 
    headers=headers
)
print("User History:", history.json())

# 4. Search for specific content
search = requests.get(
    f"{base_url}/api/room101/search?terms=cryptocurrency&terms=trading", 
    headers=headers
)
print("Content Search:", search.json())

Ethical Use: Room 101 provides powerful Reddit analysis capabilities. Ensure your use complies with Reddit's terms of service and applicable privacy laws. Use only for legitimate investigative purposes.

Error Handling

The API uses standard HTTP status codes and returns detailed error messages.

Status Code Meaning Description
200 OK Request successful
400 Bad Request Invalid request format
401 Unauthorized Invalid or missing API key
403 Forbidden Search term is blacklisted
429 Too Many Requests Rate limit exceeded
500 Internal Server Error Server error occurred

Error Response Example

401 Unauthorized
{
  "detail": "Invalid API Key"
}