Email Finder

The Email Finder API helps you discover verified business email addresses for the right contacts using just a name and company or domain, so you can enrich your CRM, power outbound campaigns, and scale prospecting workflows without manual research

Instant Email Finder

post

Instantly discover email address of any person giving their name and domain or company name

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

Name of the person (eg:- Mr. Tony Stark or Robert Downey Jr.)

Example: Steven Morris

domainstringRequired

Domain or Company name (eg:- marvel.com or Marvel Entertainment Company)

Example: apple.com

timeoutinteger · max: 180000Optional

Request wait time (in milliseconds)

Default: 30000Example: 30000

queuebooleanOptional

Flag to indicate whether email discovery can be performed in background even after the request timed out, this will help to retrieve result later using queue id or downloaded from Clearout App -> My Activities. Setting 'false' will stop the email discovery immediately when timeout occured

Default: trueExample: false

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

429

Too Many Requests

application/json

503

Service Unavailable

524

A Timeout Occurred

application/json

post

/email_finder/instant

HTTPcURLJavaScriptPython

POST /v2/email_finder/instant HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "name": "Steven Morris",
  "domain": "apple.com",
  "timeout": 30000,
  "queue": false
}

{
  "status": "success",
  "data": {
    "emails": [],
    "first_name": "steven",
    "last_name": "morris",
    "full_name": "steven morris",
    "domain": "apple.com",
    "confidence_score": 83,
    "total": 1,
    "company": {
      "name": "apple"
    },
    "found_on": "2021-08-21T03:10:02.796Z"
  }
}

Instant Email Finder Status

get

To know the email finder request status in queue

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

qidstringRequired

Queue ID received as part of the instant email finder response object

Example: 61008c4597947d45700f4bb2

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

503

Service Unavailable

get

/email_finder/instant/queue_status

HTTPcURLJavaScriptPython

GET /v2/email_finder/instant/queue_status?qid=61008c4597947d45700f4bb2 HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success",
  "data": {
    "emails": [],
    "first_name": "steven",
    "last_name": "morris",
    "full_name": "steven morris",
    "domain": "apple.com",
    "confidence_score": 83,
    "total": 1,
    "company": {
      "name": "apple"
    },
    "found_on": "2021-08-21T03:10:02.796Z"
  }
}

Bulk Email Finder

post

Use bulk finder API to discover the email address of the person in contact list of any size. Email discovery process will occur in background and once complete it will be notified through email. Use Bulk Email Finder Progress Status API to know the overall completion status of the list in percentage

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

filestring · base64Required

ignore_duplicate_filestringOptional

Whether to allow file with the same name and size that match with your recent upload

Default: falseExample: true

Responses

200

OK

application/json

or

or

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email_finder/bulk

HTTPcURLJavaScriptPython

POST /v2/email_finder/bulk HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 44

{
  "file": "text",
  "ignore_duplicate_file": true
}

{
  "status": "success",
  "data": {
    "list_id": "610097bf5c6d3469958acd29"
  }
}

Bulk Email Finder Progress Status

get

To know the overall progress status of the bulk finder request

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

list_idstringRequired

Pass the value of bulk list_id property from response object

Example: 5d076c8e3b53f9b0f3cf6abb

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

503

Service Unavailable

get

/email_finder/bulk/progress_status

HTTPcURLJavaScriptPython

GET /v2/email_finder/bulk/progress_status?list_id=5d076c8e3b53f9b0f3cf6abb HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success",
  "data": {
    "progress_status": "running",
    "percentage": 18
  }
}

Bulk Finder Result Download

post

Bulk email finder result file download

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

list_idstringRequired

Pass the value of bulk list_id property from response object

Example: 5d076c8e3b53f9b0f3cf6abb

Responses

200

OK

application/json

or

or

400

Bad Request

application/json

401

Unauthorized

application/json

503

Service Unavailable

post

/email_finder/download/result

HTTPcURLJavaScriptPython

POST /v2/email_finder/download/result HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "list_id": "5d076c8e3b53f9b0f3cf6abb"
}

{
  "status": "success",
  "data": {
    "url": "https://s3.ap-south-1.amazonaws.com/clearout.others/60f76977473718917ebc6edb/61009e745c6d3469958ace11/results/test3_appended_clearout_finder_results.csv"
  }
}

Bulk Email Finder Removal

post

Remove your bulk finder contact list

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

list_idstringRequired

Pass the value of bulk list_id property from response object

Example: 5d076c8e3b53f9b0f3cf6abb

ignore_resultbooleanOptional

Set this value to true when download request is in progress, otherwise list removal will be denied

Default: falseExample: true

Responses

200

OK

application/json

or

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

503

Service Unavailable

post

/email_finder/list/remove

HTTPcURLJavaScriptPython

POST /v2/email_finder/list/remove HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "list_id": "5d076c8e3b53f9b0f3cf6abb",
  "ignore_result": true
}

{
  "status": "success",
  "data": {
    "name": "email_verify.xlsx",
    "source": "upload",
    "created_on": "2022-05-16 10:41:30.427Z"
  }
}

Bulk Finder Cancel

post

Cancel running bulk finder list

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

list_idstringRequired

Pass the value of bulk list_id property from response object

Example: 5d076c8e3b53f9b0f3cf6abb

Responses

200

OK

application/json

or

or

400

Bad Request

application/json

503

Service Unavailable

post

/email_finder/list/cancel

HTTPcURLJavaScriptPython

POST /v2/email_finder/list/cancel HTTP/1.1
Host: api.clearout.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "list_id": "5d076c8e3b53f9b0f3cf6abb"
}

{
  "status": "success",
  "data": {
    "name": "email_verify.xlsx",
    "source": "upload",
    "created_on": "2022-05-16 10:41:30.427Z"
  }
}