Skip to main content
GET
Email OSINT
Discover which websites an email address is registered on.
Purpose Identification Required: This endpoint requires you to specify the purpose/reason for your OSINT search. You can provide this in 4 different ways (in order of priority):
  1. Query Parameter: ?purpose=Your%20Purpose
  2. X-Purpose Header: X-Purpose: Your Purpose
  3. Purpose Header: Purpose: Your Purpose
  4. User-Agent Header: Include Purpose: Your Purpose within the User-Agent string
Credits Required: This endpoint requires email OSINT credits to perform searches. Credits are deducted only after a successful search. Check your credit balance using the /api/user endpoint, which includes email OSINT credit information in its response.

Parameters

string
required
Email address to investigate
string
Purpose/reason for the OSINT search (can also be provided via headers)

Headers

string
required
Your API key
string
Alternative way to provide the purpose (takes priority over query parameter)
string
Alternative way to provide the purpose
string
Can include Purpose: Your Purpose within the User-Agent string

Credit System

Email OSINT searches require credits to be performed. The cost per search varies by your subscription plan:
Monthly Credits: Free credits are automatically awarded on the first of each month based on your plan. Free credits are not stackable - unused credits from previous months do not accumulate.
Credit Deduction: Credits are deducted only after a successful API response. Failed requests (due to invalid parameters, rate limits, etc.) do not consume credits.

Check Credit Balance

Before making a search request, you can check your current credit balance using the /api/user endpoint, which includes email OSINT credit information: Endpoint: GET /api/user
The email_osint_credits object in the response contains:
  • current_balance: Current credit balance in EUR
  • price_per_search: Cost per search based on your plan
  • has_sufficient_credits: Whether you have enough credits for at least one search
  • searches_available: Estimated number of searches available with current balance
See the User Info endpoint documentation for the complete response structure.

Response

Returns information about websites where the email address is registered. Credits are deducted after a successful response.

Example Request

Error Responses

Insufficient Credits (402 Payment Required)

If you don’t have enough credits to perform a search, you’ll receive a 402 status code:

Rate Limit Exceeded (429 Too Many Requests)

If you exceed the rate limit of 3 requests per second, you’ll receive a 429 status code. This does not consume credits.

Other Status Codes

  • 200 OK - Success (credits are deducted)
  • 400 Bad Request - Missing or invalid parameters (no credits deducted)
  • 403 Forbidden - Invalid or missing API key (no credits deducted)
  • 429 Too Many Requests - Rate limit exceeded (no credits deducted)
  • 500 Internal Server Error - Server error (no credits deducted)