Announcement: Join our telegram for updates! [here](https://t.me/minerva_public)

Minerva OSINT API Documentation

The Minerva OSINT API provides programmatic access to advanced email OSINT and breach lookup features. Secure your accounts, enrich user data, and automate investigations.
Base URL: https://api.minervaosint.com

Authentication & Plans

All endpoints require an API key in the Authorization header as Bearer <API_KEY>.
Plans:

Plan Rate Limit (per request) Features
Basic 1 request / 60s Full Email OSINT
Pro 1 request / 30s Full Email OSINT
Enterprise Custom Custom
Add-on: Breach Access 1 breach request / 5s Access to breach lookup endpoint

Note: Breach lookup requires the "Breach Access" add-on key.

Status Endpoint

GET /status

Check API status and remaining requests.

Header Required Description
Authorization Yes Bearer <API_KEY>
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.minervaosint.com/status
{
  "status": "The API is currently up and running correctly.",
  "requestsLeft": 123
}

Email OSINT Endpoint

POST /search/email_osint

Performs advanced OSINT lookup on an email address.

Parameter Type Required Description
email string (JSON body) Yes Email address to search
Authorization header Yes Bearer <API_KEY>
curl -X POST https://api.minervaosint.com/search/email_osint \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'
{
  "register": [
    {
      "type": "register",
      "name": "clickup",
      "website": "clickup.com",
      "status": "VALID",
      "extraData": {
        "sso_required": false,
        "google_sso": false,
        "azure_sso": false,
        "okta_sso": false
      }
    },
    {
      "type": "register",
      "name": "dropbox",
      "website": "dropbox.com",
      "status": "VALID",
      "extraData": {}
    },
    {
      "type": "register",
      "name": "patreon",
      "website": "patreon.com",
      "status": "RATELIMIT",
      "extraData": null
    }
  ],
  "api": [
    {
      "type": "api",
      "name": "adobe",
      "website": "adobe.com",
      "status": "VALID",
      "extraData": {
        "account_type": "individual",
        "auth_methods": "google",
        "account_status": "active"
      }
    },
    {
      "type": "api",
      "name": "duolingo",
      "website": "duolingo.com",
      "status": "VALID",
      "extraData": {
        "username": "CoolUsername",
        "name": "John Doe",
        "profile_url": "https://www.duolingo.com/profile/Link To Profile"
      }
    },
    {
      "type": "api",
      "name": "notion",
      "website": "notion.so",
      "status": "ERROR",
      "extraData": ""
    }
  ],
  "breach": []
}

Breach Lookup Endpoint [Add-on]

POST /search/breach

Uncover exposed passwords and breach records for an email address. Requires Breach Access add-on.
Cooldown: 1 request per 5 seconds.

Parameter Type Required Description
email string (JSON body) Yes Email address to check for breaches
Authorization header Yes Bearer <API_KEY> (with breach access)
curl -X POST https://api.minervaosint.com/search/breach \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'
[
    {
        "password": "securepassword123",
        "source": {
            "name": "Last.fm",
            "breach_date": "2012-07",
            "unverified": 0,
            "passwordless": 0,
            "compilation": 0
        },
        "username": "CoolUsername6969",
        "email": "[email protected]",
        "fields": ["password", "username", "email"]
    }
]

Rate Limits & Quotas

Error Codes

Error HTTP Code Description
MISSING_API_KEY 401 No API key provided in Authorization header
INVALID_API_KEY 403 API key not found or invalid
ACCESS_EXPIRED 400 API key expired
NO_REQUESTS_LEFT 400 API key quota exhausted
TOO_MANY_REQUESTS 429 Rate limit exceeded; includes wait_seconds
ADDON_REQUIRED 403 Breach endpoint requires add-on
EMAIL_REQUIRED 400 Email parameter missing
INTERNAL_ERROR 500 Unexpected server error
UNKNOWN_ENDPOINT 404 Invalid endpoint

Support

For help or to upgrade your plan, contact Contact Us.