FIfindymail
Misc

Find employees

Changed on

Find one or more employees using the company website and job title.

Rate limit: 50 simultaneous requests.

Credit cost (credit-based plans): 1 finder credit per employee returned. Free when no employee is found.

This endpoint does NOT return an email.

post/api/search/employees

Request

  • Base URL
    https://app.findymail.com
  • URL
    https://app.findymail.com/api/search/employees
  • Auth
    HTTP bearer

Request body

websitestring required

company website

job_titlesstring[] required

target job titles (max 10)

countinteger

Number of contacts to return (max 3). Default 1. A value of 4 or 5 is accepted and reduced to 3.

Example request

{
  "website": "google.com",
  "job_titles": [
    "Software Engineer",
    "CEO"
  ],
  "count": 2
}

Response

namestring
linkedinUrlstring
companyWebsitestring
companyNamestring
jobTitlestring

Example response

[
  {
    "name": "John Done",
    "linkedinUrl": "https://www.linkedin.com/in/john-doe/",
    "companyWebsite": "https://www.findymail.com",
    "companyName": "Findymail",
    "jobTitle": "Software Engineer"
  }
]

Changes

  • b6b5ecb380dbRevision changes
    • info

      added the non-success response with the status

  • ae7fddf16bf9Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status