API Documentation

v1.0Stable

API Documentation

REST API for email discovery and data enrichment

Quick Start

1️⃣

Get API Key

Create an account and generate your key from dashboard

2️⃣

Search Data

Use search endpoints to find emails, logs, or tech data

3️⃣

Download Results

Use search_id to download full data

Authentication

All API requests require authentication using an API key. Include your key in theX-API-Keyheader:

bash

X-API-Key: fe_your_api_key_here

Rate Limits

Rate limits are based on your plan tier. Exceeding returns 429 status.

Plan	Requests/min	Daily Searches
Free	10	50
Starter	30	200
Pro	100	1,000
Business	300	5,000
Enterprise	1,000	Unlimited

Error Codes

Code	Status	Description
MISSING_API_KEY	401	API key not provided
INVALID_API_KEY	401	API key is invalid or expired
RATE_LIMITED	429	Too many requests
INSUFFICIENT_CREDITS	402	Not enough credits
PLAN_RESTRICTION	403	Feature not available on plan
BLACKLISTED	403	Query is blacklisted

Account Endpoints

GET/api/v1/meAuth Required

Get Current User

Returns information about the authenticated user including plan details and API key usage.

Code Example

curl

curl -X GET "https://findemail.io/api/v1/me" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json"

GET/api/v1/creditsAuth Required

Check Credits Balance

Returns current credit balance, plan information and remaining allowances for each data type.

Code Example

curl

curl -X GET "https://findemail.io/api/v1/credits" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json"

Search Endpoints

POST/api/v1/domain/searchAuth Required

Search Domain Emails

Search for email addresses associated with a specific domain. Returns sample emails (masked) and total count.

Request Body

Parameter	Type	Required	Description
domain	string	Yes	Domain name to search (e.g., "example.com")

Code Example

curl

curl -X POST "https://findemail.io/api/v1/domain/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

POST/api/v1/logs/searchAuth Required

Search Logs/Credentials

Search leaked credentials by domain, subdomain, or username. Returns matched records count.

Request Body

Parameter	Type	Required	Description
q	string	Yes	Search query
filter	string	No	Filter: "domain" \| "sub_domain" \| "username"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/logs/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"example.com","filter":"domain"}'

POST/api/v1/tech/searchAuth Required

Search by Technology

Find domains using specific CMS, web server, or IP address.

Request Body

Parameter	Type	Required	Description
q	string	Yes	CMS name, web server, or IP
mode	string	No	Mode: "cms" \| "web_server" \| "ip"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/tech/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"example.com","mode":"domain"}'

POST/api/v1/leak/searchAuth Required

Search Leaked Data

Search leaked data by domain, email, username, IP, or phone number.

Request Body

Parameter	Type	Required	Description
q	string	Yes	Search query
mode	string	No	Mode: "domain" \| "email" \| "username" \| "ip" \| "phone"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/leak/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"example.com","mode":"domain"}'

POST/api/v1/bulk/searchAuth Required

Bulk Domain Check

Check multiple domains at once (up to 25). Returns record counts for each domain.

Request Body

Parameter	Type	Required	Description
domains	array	Yes	Array of domain names (max 25)

Code Example

curl

curl -X POST "https://findemail.io/api/v1/bulk/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domains":["example.com","test.org"]}'

Download Endpoints

POST/api/v1/download/domainAuth Required

Download Domain Emails

Download email addresses from a previous domain search. Uses credits or plan allowance.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID from the search response
count	number	No	Number of records (default: 1000)
format	string	No	Format: "text" \| "json"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/domain" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'

POST/api/v1/download/logsAuth Required

Download Logs Data

Download credentials/logs from a previous search. Includes URL, username, password.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID
count	number	No	Number of records (default: 1000)
format	string	No	Format: "json" \| "csv"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/logs" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'

POST/api/v1/download/techAuth Required

Download Tech Data

Download technology search results including IP, CMS, web server, and domain.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID
count	number	No	Number of records (default: 1000)
format	string	No	Format: "json" \| "jsonl"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/tech" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'

POST/api/v1/download/leakAuth Required

Download Leak Data

Download leaked data including emails, usernames, passwords, and IPs.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID
count	number	No	Number of records (default: 1000)
format	string	No	Format: "json" \| "csv" \| "text"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/leak" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'

Plan

Requests/min

Daily Searches

Free

Starter

200

Pro

100

1,000

Business

300

5,000

Enterprise

1,000

Unlimited

Code

Status

Description

MISSING_API_KEY

401

API key not provided

INVALID_API_KEY

401

API key is invalid or expired

RATE_LIMITED

429

Too many requests

INSUFFICIENT_CREDITS

402

Not enough credits

PLAN_RESTRICTION

403

Feature not available on plan

BLACKLISTED

403

Query is blacklisted

Account Endpoints

GET/api/v1/meAuth Required

Get Current User

Returns information about the authenticated user including plan details and API key usage.

Code Example

curl

curl -X GET "https://findemail.io/api/v1/me" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json"

GET/api/v1/creditsAuth Required

Check Credits Balance

Returns current credit balance, plan information and remaining allowances for each data type.

Code Example

curl

curl -X GET "https://findemail.io/api/v1/credits" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json"

Search Endpoints

POST/api/v1/domain/searchAuth Required

Search Domain Emails

Search for email addresses associated with a specific domain. Returns sample emails (masked) and total count.

Request Body

Parameter	Type	Required	Description
domain	string	Yes	Domain name to search (e.g., "example.com")

Code Example

curl

curl -X POST "https://findemail.io/api/v1/domain/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

POST/api/v1/logs/searchAuth Required

Search Logs/Credentials

Search leaked credentials by domain, subdomain, or username. Returns matched records count.

Request Body

Parameter	Type	Required	Description
q	string	Yes	Search query
filter	string	No	Filter: "domain" \| "sub_domain" \| "username"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/logs/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"example.com","filter":"domain"}'

POST/api/v1/tech/searchAuth Required

Search by Technology

Find domains using specific CMS, web server, or IP address.

Request Body

Parameter	Type	Required	Description
q	string	Yes	CMS name, web server, or IP
mode	string	No	Mode: "cms" \| "web_server" \| "ip"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/tech/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"example.com","mode":"domain"}'

POST/api/v1/leak/searchAuth Required

Search Leaked Data

Search leaked data by domain, email, username, IP, or phone number.

Request Body

Parameter	Type	Required	Description
q	string	Yes	Search query
mode	string	No	Mode: "domain" \| "email" \| "username" \| "ip" \| "phone"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/leak/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"example.com","mode":"domain"}'

POST/api/v1/bulk/searchAuth Required

Bulk Domain Check

Check multiple domains at once (up to 25). Returns record counts for each domain.

Request Body

Parameter	Type	Required	Description
domains	array	Yes	Array of domain names (max 25)

Code Example

curl

curl -X POST "https://findemail.io/api/v1/bulk/search" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domains":["example.com","test.org"]}'

Download Endpoints

POST/api/v1/download/domainAuth Required

Download Domain Emails

Download email addresses from a previous domain search. Uses credits or plan allowance.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID from the search response
count	number	No	Number of records (default: 1000)
format	string	No	Format: "text" \| "json"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/domain" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'

POST/api/v1/download/logsAuth Required

Download Logs Data

Download credentials/logs from a previous search. Includes URL, username, password.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID
count	number	No	Number of records (default: 1000)
format	string	No	Format: "json" \| "csv"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/logs" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'

POST/api/v1/download/techAuth Required

Download Tech Data

Download technology search results including IP, CMS, web server, and domain.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID
count	number	No	Number of records (default: 1000)
format	string	No	Format: "json" \| "jsonl"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/tech" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'

POST/api/v1/download/leakAuth Required

Download Leak Data

Download leaked data including emails, usernames, passwords, and IPs.

Request Body

Parameter	Type	Required	Description
id	string	Yes	Search ID
count	number	No	Number of records (default: 1000)
format	string	No	Format: "json" \| "csv" \| "text"

Code Example

curl

curl -X POST "https://findemail.io/api/v1/download/leak" \
  -H "X-API-Key: fe_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_SEARCH_ID","count":1000,"format":"json"}'