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 primary intelligence services with a single request: LeakCheck, KeyScore, and HackCheck. This endpoint provides fast, parallel processing of your search across our core breach databases for optimal performance. For access to all 15+ specialized 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 LeakCheck, HackCheck, Keyscore [email protected]
username Username search LeakCheck, HackCheck, Keyscore johndoe123
phone Phone number search LeakCheck, HackCheck, Keyscore +1234567890
domain Domain investigation LeakCheck, HackCheck, Keyscore example.com
ip IP address analysis LeakCheck, HackCheck, Keyscore 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": {
    "leakcheck": { ... },
    "hackcheck": { ... },
    "keyscore": { ... }
  }
}

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"
    ]
  }
}

KeyScore

Advanced breach database search with powerful filtering and multi-source capabilities.

POST /api/keyscore/search

Request Body

{
  "terms": ["[email protected]"],
  "types": ["email"],
  "source": "xkeyscore",
  "wildcard": false,
  "regex": false,
  "operator": "OR",
  "page": 1,
  "pagesize": 10000
}

Search Operators

Operator Description Use Case
OR Match any term (default) Broad searches
AND Match all terms in same record Precise targeting
LOGS Filter to log records only Stealer logs analysis
RANGE Date range filtering Time-based analysis

Date Range Search Example

RANGE Operator with Dates
curl -X POST "https://osintdog.com/api/keyscore/search" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "terms": ["admin"],
    "types": ["email"],
    "source": "xkeyscore",
    "operator": "RANGE",
    "dateFrom": "01_08_2025",
    "dateTo": "15_08_2025"
  }'

Additional KeyScore Endpoints

Endpoint Method Description
/api/keyscore/hashlookup POST Hash cracking and lookup
/api/keyscore/iplookup POST IP geolocation and analysis

Advanced Parameters

Parameter Type Description Example
pages string Specific pages to retrieve "1,2,3"
source string Data source to search "xkeyscore"

Multi-Source Platform: KeyScore aggregates data from multiple breach databases and provides advanced filtering capabilities for comprehensive investigations.

Dump.cat

Professional breach data search with async processing and file retrieval capabilities.

Async Processing: Dump.cat uses asynchronous search processing. Initialize searches, then poll for results using the returned search ID.

Initialize Search

POST /api/dumpcat/search/init

Request Body

{
  "term": "[email protected]",
  "sort": 2,
  "datefrom": "2024-01-01T00:00:00.000Z",
  "dateto": "2024-12-31T23:59:59.999Z"
}

Sort Options

Sort Value Description Best For
1 Date filtered Use with date range
2 Most relevant (default) General searches
3 Newest first Recent data
4 Oldest first Historical analysis

Get Search Results

POST /api/dumpcat/search/results

Request Body

{
  "search_id": "a2fa51bf-7876-4b8f-9737-511452485e2c",
  "limit": 10,
  "offset": 0
}

Reverse Lookup

POST /api/dumpcat/reverse/init

Request Body

{
  "term": "https://example.com"
}

Description: Find all credentials associated with a domain or URL.

Get Reverse Lookup Results

GET /api/dumpcat/reverse/results/{lookup_id}

Parameters

Parameter Type Required Description
lookup_id path Yes The lookup ID returned from reverse/init
limit query No Maximum results to return (default: 5000)

Description: Retrieve results from a previously initialized reverse lookup.

File Data Retrieval

POST /api/dumpcat/file

Request Body

{
  "storage_id": "cb28d6ac-c18c-442c-9b02-430bbd44e081",
  "bucket": "leaks.logs"
}

Description: Retrieve complete file content using storage ID and bucket from search results.

Complete Workflow Examples

Standard Search Workflow

Dump.cat Search Workflow
# 1. Initialize search
curl -X POST "https://osintdog.com/api/dumpcat/search/init" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"term": "[email protected]", "sort": 2}'

# 2. Wait 5-10 seconds for processing

# 3. Get results using returned search_id
curl -X POST "https://osintdog.com/api/dumpcat/search/results" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"search_id": "YOUR_SEARCH_ID", "limit": 10, "offset": 0}'

# 4. Get file content using storage_id and bucket from results
curl -X POST "https://osintdog.com/api/dumpcat/file" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"storage_id": "STORAGE_ID", "bucket": "BUCKET_NAME"}'

Reverse Lookup Workflow

Dump.cat Reverse Lookup Workflow
# 1. Initialize reverse lookup
curl -X POST "https://osintdog.com/api/dumpcat/reverse/init" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"term": "https://example.com"}'

# 2. Wait 5-10 seconds for processing

# 3. Get reverse lookup results using returned lookup_id
curl -X GET "https://osintdog.com/api/dumpcat/reverse/results/YOUR_LOOKUP_ID?limit=100" \
  -H "X-API-Key: your_api_key_here"

IdLeakCheck

Comprehensive people search with support for multiple personal identifiers and source filtering.

POST /api/idleakcheck

Request Body

{
  "firstName": "John",
  "lastName": "Doe",
  "phone1": "+1234567890",
  "city": "New York",
  "state": "NY",
  "sources": ["npd"]
}

Search Parameters

Parameter Type Description Example
firstName string First name John
lastName string Last name Doe
phone1 string Phone number +1234567890
address string Street address 123 Main St
city string City name New York
state string State code NY
zip string ZIP code 10001
ssn string Social Security Number XXX-XX-XXXX
dob string Date of birth 1990-01-01
sources array Filter by data sources ["npd", "other"]

Example Searches

Name and Phone Search
curl -X POST "https://osintdog.com/api/idleakcheck" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "phone1": "+1234567890"
  }'
NPD-Only Search
curl -X POST "https://osintdog.com/api/idleakcheck" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "sources": ["npd"]
  }'

GET Parameter Alternative

GET /api/idleakcheck?firstName=John&lastName=Doe&phone1=1234567890&sources=npd

Legal Compliance: IdLeakCheck searches personal data including SSNs and addresses. Ensure compliance with applicable privacy laws and use only for legitimate investigative purposes with proper authorization.

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.

Shodan API

Shodan is a search engine for Internet-connected devices. Query information about hosts, search for vulnerabilities, and analyze network infrastructure with comprehensive device intelligence.

Host Information

POST /api/shodan/host

Request Body

{
  "ip": "8.8.8.8",
  "history": false,
  "minify": false
}

Parameters

  • ip (string, required): IP address to lookup
  • history (boolean): Include historical data
  • minify (boolean): Minify response

Search Hosts

POST /api/shodan/search

Request Body

{
  "query": "apache country:US",
  "facets": "country,org",
  "page": 1,
  "minify": false
}

DNS Lookup

POST /api/shodan/dns

Request Body

{
  "domain": "example.com",
  "history": false,
  "type": "A",
  "page": 1
}

Reverse DNS Lookup

GET /api/shodan/dns/reverse?ips=8.8.8.8,1.1.1.1

Exploit Search

POST /api/shodan/exploits

Request Body

{
  "query": "apache",
  "facets": "type,platform",
  "page": 1
}

Honeyscore Check

POST /api/shodan/honeyscore

Request Body

{
  "ip": "8.8.8.8"
}

Returns a score from 0.0 to 1.0 indicating likelihood of honeypot.

Available Ports & Protocols

GET /api/shodan/ports
GET /api/shodan/protocols

API Information

GET /api/shodan/api-info

Get your Shodan API plan information and usage statistics.

Genesis API

Genesis API provides comprehensive user lookup services for Discord and Steam accounts. Retrieve detailed user information and account history from these platforms.

Discord Lookup

GET /api/genesis/discord?id=USER_ID

Parameters

  • id (string, required): Discord user ID

Response

Returns comprehensive Discord user information including profile data, account creation date, and associated metadata.

Steam Lookup

GET /api/genesis/steam?id=STEAM_ID

Parameters

  • id (string, required): Steam user ID or vanity URL

Response

Returns Steam user profile information, game library, account status, and public profile data.

GitHub OSINT

Find GitHub accounts and repositories associated with email addresses. Discover public GitHub profiles and contribution history through email-based OSINT.

Parameters

  • email (string, required): Email address to search

Response

Returns associated GitHub accounts, repositories, commit history, and public profile information.

Example Request

curl -X GET "https://osintdog.com/api/[email protected]" \
  -H "X-API-Key: your_api_key_here"

Minecraft OSINT

Search Minecraft stealer logs and account information. Query Minecraft username history and associated account data from compromised databases.

GET /api/minecraft?query=username

Parameters

  • query (string, optional): Minecraft username or email to search

Response

Returns Minecraft account information from stealer logs, including username history, associated emails, and account details.

Example Request

curl -X GET "https://osintdog.com/api/minecraft?query=PlayerName123" \
  -H "X-API-Key: your_api_key_here"

Discord Stalker

Advanced Discord user reconnaissance tool. Retrieve comprehensive Discord user information, server history, and account metadata for detailed user profiling.

GET /api/discord-stalker?query=USER_ID

Parameters

  • id (string, required): Discord user ID

Response

Returns detailed Discord user profile, account history, server memberships, and associated metadata for comprehensive user analysis.

Example Request

curl -X GET "https://osintdog.com/api/discord-stalker?query=123456789012345678" \
  -H "X-API-Key: your_api_key_here"

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"
}