API Documentation

Complete guide to integrate with Quick Enrich API

Production Ready API Key Protected Rate Limited
GET /api/employees/search

Search Employee Data

Search for employees using LinkedIn URL AND/OR company URL, first name, and last name.
If you submit all 4 fields, it will FIRST search for the LinkedIn URL and if nothing is found it will search and verify the emails for the first name, last name, company URL.

Parameters
Parameter Type Required Description
linkedin_url string No* LinkedIn profile URL (exact match)
company_url string No* Company website URL (exact match)
first_name string No* Employee first name (exact match)
last_name string No* Employee last name (exact match)
Example Response
Response Format
{
  "success": true,
  "message": "Employees fetched",
  "code": 200,
  "data": {
    "first_name": "John",
    "last_name": "Doe",
    "title": "Senior Software Engineer",
    "email": "[email protected]",
    "employee_phone": "+1-555-0123",
    "employee_linkedin": "https://linkedin.com/in/johndoe",
    "email_verification_date": "2024-01-15",
    "company_url": "https://techcorp.com",
    "company_name": "Tech Corp",
    "email_domain": "company.com"
  }
}
Test This Endpoint
Response:

                        
Error Error Responses

Common Error Responses

401 Unauthorized

Invalid or missing API key

{
  "success": false,
  "message": "Invalid API key",
  "code": 401
}
429 Too Many Requests

Rate limit exceeded

{
  "success": false,
  "message": "Rate limit exceeded. Try again later.",
  "code": 429
}
400 Bad Request

Invalid parameters or missing required fields

{
  "success": false,
  "message": "Invalid search parameters. Provide either linkedin_url OR (company_url, first_name, last_name)",
  "code": 400
}