Breach Search Guide

​

Overview

• search for rows with a broad query or exact filters
• narrow the search to known breach sources, fields, dates, or structured logic
• use autocomplete before large searches to discover valid db names and fields
• use AI filters when a user describes the target in natural language

​

Basic Search

curl -G "https://oathnet.org/api/service/v2/breach/search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "q=user@example.com" \
  --data-urlencode "dbname[]=linkedin_2012"

import requests

response = requests.get(
    "https://oathnet.org/api/service/v2/breach/search",
    params={
        "q": "user@example.com",
        "dbname[]": ["linkedin_2012"],
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

payload = response.json()
print(payload["data"]["meta"]["total"])
print(payload.get("_meta", {}).get("lookups", {}).get("left_today"))

{
  "success": true,
  "message": "Breach search completed",
  "data": {
    "items": [
      {
        "email": "user@example.com",
        "email_domain": "example.com",
        "username": "user123",
        "password": "hunter2",
        "country": "US",
        "dbname": "linkedin_2012"
      }
    ],
    "meta": {
      "count": 1,
      "total": 1,
      "took_ms": 8,
      "has_more": false,
      "total_pages": 1
    },
    "next_cursor": null
  },
  "_meta": {
    "lookups": {
      "left_today": 9998
    }
  }
}

​

Filters And Pagination

• q for broad auto-detected queries
• flat filters such as email[], phone[], country[], dbname[], and password_hash[]
• logic=and|or
• wildcard=true
• cursor for pagination
• filter and filter_id for structured filtering

​

Natural Language Filters

import requests

filter_response = requests.post(
    "https://oathnet.org/api/service/v2/ai/filter",
    json={
        "index": "breach",
        "query": "US banking customers with gmail addresses and linkedin data"
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

filter_id = filter_response.json()["filter_id"]

search_response = requests.get(
    "https://oathnet.org/api/service/v2/breach/search",
    params={"filter_id": filter_id},
    headers={"x-api-key": "YOUR_API_KEY"},
)

​

Discovery Helpers