Minerva OSINT API Documentation

The Minerva OSINT API provides programmatic access to advanced email OSINT investigations. Enrich user data, automate background checks, and gather intelligence across 70+ platforms.
Base URL: https://api.minervaosint.com

Authentication & Pricing

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

Plan	Rate Limit	Price per Request	Credits Never Expire
Individual	30 requests / minute	€0.002	✅ Yes

Purchase Options: €9.99 for 5,000 credits • View detailed pricing

Status Endpoint

GET /status

Check API status and remaining credits.

Header	Required	Description
Authorization	Yes	`Bearer <API_KEY>`

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.minervaosint.com/status

{
  "status": "Ready",
  "credits": 4850,
  "tier": "individual",
  "rate_limit": {
    "requests_per_minute": 30,
    "dedicated_endpoint": false
  },
  "features": ["email_osint"],
  "lastUsage": "2025-09-21T19:42:15.123Z"
}

Email OSINT Endpoint

POST /search/email_osint

Performs comprehensive OSINT lookup on an email address across 70+ platforms including social media, professional networks, and online services.

Parameter	Type	Required	Description
email	string (JSON body)	Yes	Valid email address to investigate
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]"}'

{
  "results": {
    "register": [
      {
        "type": "register",
        "website": "clickup.com",
        "status": "VALID",
        "extraData": {
          "sso_required": false,
          "google_sso": false,
          "azure_sso": false,
          "okta_sso": false
        }
      },
      {
        "type": "register",
        "website": "dropbox.com",
        "status": "VALID",
        "extraData": {}
      }
    ],
    "api": [
      {
        "type": "api",
        "website": "adobe.com",
        "status": "VALID",
        "extraData": {
          "account_type": "individual",
          "auth_methods": "google",
          "account_status": "active"
        }
      },
      {
        "type": "api",
        "website": "duolingo.com",
        "status": "VALID",
        "extraData": {
          "username": "CoolUsername",
          "name": "John Doe",
          "profile_url": "https://www.duolingo.com/profile/Link_To_Profile"
        }
      }
    ]
  },
  "metadata": {
    "tier": "individual",
    "credits_remaining": 4849,
    "search_timestamp": "2025-09-21T19:45:32.456Z"
  }
}

Rate Limits & Quotas

Individual Plan: 30 requests per minute (2-second cooldown between requests).
Exceeding rate limits returns 429 TOO_MANY_REQUESTS with wait_seconds and rate limit information.
When credits are exhausted, you'll receive 400 NO_REQUESTS_LEFT.
Credits never expire - purchase once, use anytime.

Response Status Codes

Status	Description
VALID	Email found and verified on the platform

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
NO_REQUESTS_LEFT	400	API key credits exhausted
TOO_MANY_REQUESTS	429	Rate limit exceeded; includes `wait_seconds` and `rate_limit_info`
EMAIL_REQUIRED	400	Email parameter missing from request body
INVALID_EMAIL_FORMAT	400	Email address format is invalid
METHOD_NOT_ALLOWED	405	HTTP method not supported for endpoint
INTERNAL_ERROR	500	Unexpected server error
UNKNOWN_ENDPOINT	404	Invalid API endpoint

Getting Started

Purchase credits - €9.99 for 5,000 credits (€0.002 per request)
Generate your API key from your account
Make your first request to /search/email_osint
Process results and integrate with your application

Your credits never expire - purchase once and use them whenever you need.

Support

Need help with integration? Contact us at Contact Us for assistance.