Skip to content
API Reference/Companies/
Search Companies

Revealed Employee Finder API (1.0.0)

API for finding employee contact information from companies using various criteria.

Download OpenAPI description
index.json
index.yaml
Overview
API Support
api-support@revealead.com
License
Proprietary
Languages
Servers
Mock server
https://docs.revealead.com/_mock/apis
Production Server
https://api.revealead.app/employeefinder

Companies

Operations

Search Companies

Request

Search for companies containing contacts matching specified criteria (seniority, department, etc.).

Security
ApiKeyHeader or ApiKeyQuery
Query
contact_level_codeArray of strings

Filter by contact seniority level(s).

Items Enum"EXECUTIVE""DIRECTOR""MANAGER""SUPERVISOR""ASSISTANT""COLLABORATOR""OTHER"
contact_domain_codeArray of strings

Filter by department/domain (e.g., 'IT', 'Marketing', 'Sales'). Supports custom text.

contact_role_querystring

Semantic search query for job titles (e.g., "python developer").

email_test_statusstring

Filter by email verification status.

Default "all"
Enum"all""safe""notsafe"
contact_sourceArray of strings

Filter by origin of contact data.

Items Enum"linkedin""legal"
limitinteger<= 100

Number of results per page.

Default 20
cursorstring

Cursor for pagination (obtained from previous response meta).

curl -i -X GET \
  'https://docs.revealead.com/_mock/apis/companies?contact_level_code=EXECUTIVE&contact_domain_code=string&contact_role_query=string&email_test_status=all&contact_source=linkedin&limit=20&cursor=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Successful search response

Bodyapplication/json
successboolean
Example: true
metaobject(Meta)
dataArray of objects
Response
application/json
{
  "success": true,
  "meta": {
    "total": 0,
    "limit": 0,
    "next_cursor": "string",
    "has_more": true
  },
  "data": [
    { … }
  ]
}

Contacts

Operations

System

Operations