Developer Docs

API Reference

Everything you need to call the EmailKart API from your own product — authentication, endpoints, request parameters, and example responses.

Introduction

EmailKart API is built around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients. We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret API key in any public website's client-side code). JSON is returned by all API responses, including errors.

All of our API endpoints are HTTPS secured. HTTP requests are rejected.

API Main URL: https://api.emailkart.com

Authentication

In order to reach our API endpoints, you need to authenticate using your API key {Your API Key} which you must include in your HTTP request header "X-Access-Key".

Authentication to the API is performed via HTTP Basic Auth.

Your API key serves for authentication and identification, you should keep it secret.

If you are logged in, your API key is included in all the examples on this page, so you can test any example right away. Only you can see this value.

Simple HTTP request with API key

curl "https://api.emailkart.com/api/v2/account" \
 -H "X-Access-Key:{Your API Key}" \
 -H "Content-Type:application/json"

Email Finder

The Email Finder API endpoint allows you to find emails programmatically. It returns an email based on a first name, last name and a domain name.

URL: https://emailkart.com/
Method: GET

HTTP Headers

X-Access-Key: Your API key.
Content-Type: application/json

URL Query Attributes

firstName: Text
lastName: Text
domain: The domain name of the company. Example: emailkart.com. This attribute is case-insensitive. Text

JSON Response Object

pattern: The email pattern related to the domain. Text
accuracy: The accuracy of the email. Number
quality: Contains the verification status of the email. Object

Email Finder request example

curl "https://emailkart.com/?firstName=John&lastName=Doe&domain=emailkart.com" \
 -H "X-Access-Key:{Your API Key}" \
 -H "Content-Type:application/json"

Email Finder JSON response

{
  "email": "john.doe@emailkart.com",
  "pattern": "{first}.{last}",
  "accuracy": 98
}

Bulk Email Finder

The Bulk Email Finder API endpoint allows you to find emails in bulk programmatically. It takes as a request body, an array of names and companies, and returns an array of emails along with complementary data.

URL: https://emailkart.com/_bulk
Method: POST

HTTP Headers

X-Access-Key: Your API key.
Content-Type: application/json

Request Body Rules

Limit: 100

Request Body — Array of the below Object

firstName: Text
lastName: Text
domain: The domain name of the company. Example: emailkart.com. This attribute is case-insensitive. Text

JSON Response — Array of the below Object

firstName: Text
lastName: Text
name: Text
company: Text
email: Text
quality: Contains the verification status of the email. Object

Email Finder request example

curl -X POST "https://emailkart.com/_bulk" \
 -H "X-Access-Key:{Your API Key}" \
 -H "Content-Type:application/json" \
 -d '[ { "firstName" : "John", "lastName" : "Doe", "domain" : "microsoft.com" },
 { "firstName" : "John", "lastName" : "Doe", "domain" : "salesforce.com" } ]'

Email Finder JSON response

[
  {
    "firstName": "John",
    "lastName": "Doe",
    "name": "John Doe",
    "domain": "microsoft.com",
    "company": "Microsoft",
    "email": "jdoe@microsoft.com",
    "quality": {
      "status": "oka"
    }
  },
  {
    "firstName": "John",
    "lastName": "Doe",
    "name": "John Doe",
    "domain": "salesforce.com",
    "company": "Salesforce",
    "companyLinkedinID": 3185,
    "email": "jdoe@salesforce.com",
    "quality": {
      "status": "oka"
    }
  }
]

Account Data

The account data endpoint allows you to retrieve your account data programmatically. Your account data contains your name, email, social accounts, package, package expiry date, email credits and your lists names and IDs.

URL: https://api.emailkart.com/api/v2/account
Method: GET

HTTP Headers

X-Access-Key: Your API key.

JSON Response

package: Your current plan or package. Text
packageRDate: Your monthly subscription renewal date OR your package expiry date. This depends on your type of enrollment (Monthly OR One Time Purchase). Timestamp
credit: Your current credits. Used credits and total quota. Object
options: Your account privileges and options. Object
lists: Your lists information. This attribute does not return your lists data. Another resource is dedicated to this. Array

Account request example

curl "https://api.emailkart.com/api/v2/account" \
 -H "X-Access-Key:{Your API Key}" \
 -H "Content-Type:application/json"

Account JSON Response

{
  "name": "John Doe",
  "email": "john.doe@emailkart.com",
  "package": "Enterprise plan",
  "packageRDate": 1507089600000,
  "credit": {
    "email": {
      "quota": 20000,
      "used": 1000
    }
  },
  "options": {
    "csv_import": true
  },
  "lists": [
    {
      "id": 1,
      "name": "List 1",
      "path": "/app/list/1"
    },
    {
      "id": 2,
      "name": "List 2",
      "path": "/app/list/2"
    }
  ]
}

List Data

The list data endpoint allows you to retrieve all the metadata related to one of your lists. This endpoint does not return the leads saved in your list.

URL: https://api.emailkart.com/api/v2/list
Method: GET

URL Parameters

listId (/:listId/): The ID of the list. Required

HTTP Headers

X-Access-Key: Your API key.

JSON Response

list_id: The ID of your list. Number
name: The name of your list. Text
creation_date: The creation date and time of your list. Datetime
count_leads: The number of leads saved in your list. Number

List data request example

curl "https://api.emailkart.com/api/v2/list/:listId" \
 -H "X-Access-Key:{Your API Key}" \
 -H "Content-Type:application/json"

List data JSON Response

{
  "list_id": 10000,
  "name": "My List",
  "creation_date": "2020-07-16T18:34:27.325Z",
  "count_leads": 75
}

List Leads

The list leads endpoint allows you to retrieve leads from your lists. You can specify the list ID and other optional parameters to retrieve leads in a JSON format.

URL: https://api.emailkart.com/api/v2/list/:listId/leads
Method: GET

URL Parameters

listId (/:listId/): The ID of the list. Required

URL Query Attributes

start: The maximum value of the leads ID field. This ID is not inclusive. Optional Number Default: ID of most recent lead
size: The number of leads to return. Optional Number Default: 25 Maximum: 500
kw: A text keyword filter applied to the name, email, title, company website, and company name field. Optional Text

HTTP Headers

X-Access-Key: Your API key.

JSON Response

count_results: The overall number of results if a keyword is provided. Number
next_start: The value of the "start" query parameter for the next query. Number
data: An array containing the leads returned by your query. Array

Account request example

curl "https://api.emailkart.com/api/v2/list/:listId/leads?start=2500&size=100&kw=John" \
 -H "X-Access-Key:{Your API Key}" \
 -H "Content-Type:application/json"

Account JSON Response

{
  "count_results": 1000,
  "next_start": 2500,
  "data": [
    {
      "id": 2500,
      "name": "John Doe",
      "first_n": "John",
      "last_n": "Doe",
      "email": "john@example.com",
      "email_status": "ok",
      "linkedin_url": "linkedin.com/in/john-doe",
      "location": "Delaware, US",
      "domain": "example.com",
      "company_industry": "Internet",
      "company_founded": "2020",
      "company_size": 50,
      "company_hq": "Delaware, US"
    }
  ]
}