Skip to main content
GET
/
api
/
email-osint
Email OSINT
curl --request GET \
  --url https://www.osintcat.net/api/email-osint \
  --header 'X-API-KEY: <x-api-key>'
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

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

​
Headers

​
X-API-KEY
string
required
Your API key
​
X-Purpose
string
Alternative way to provide the purpose (takes priority over query parameter)
​
Purpose
string
Alternative way to provide the purpose
​
User-Agent
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:
PlanPrice per SearchMonthly Free Credits
Free€0.505 searches (€2.50)
Starter€0.4010 searches (€4.00)
Researcher€0.3020 searches (€6.00)
Investigator€0.2030 searches (€6.00)
Enterprise€0.1550 searches (€7.50)
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 
curl "https://www.osintcat.net/api/user" \
     -H "X-API-KEY: YOUR_API_KEY"
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

# Using header for API Key and X-Purpose for reason
curl "https://www.osintcat.net/api/email-osint?query=test@example.com" \
     -H "X-API-KEY: YOUR_API_KEY" \
     -H "X-Purpose: Security Research"

​
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: 
{
  "error": "INSUFFICIENT_CREDITS",
  "message": "Insufficient credits. You need 0.50€ but have 0.00€. Please purchase credits.",
  "credits_needed": 0.50,
  "credits_available": 0.00
}

​
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)