Introduction

Welcome to the EmailCrawlr API! You can use this API to get rich data about contact information and domain names.

We are working on developing more integrations for the API, but if you have any in mind contact us.

Emails

Get Email

curl "https://emailcrawlr.com/api/v2/[email protected]"
-H "x-api-key: <Your API Key>"

The above command returns JSON structured like this:

{
  "email": "[email protected]",
  "personal": false,
  "domain": "eastkent.ac.uk",
  "verified": false,
  "verify": "/v2/email/[email protected]",
  "linkedin": null,
  "twitter": {
    "twitter": "EKCProfessional",
    "confidence": 0.75
  },
  "name": {
    "confidence": 1.0,
    "name": "Professional Learning",
    "pattern": "first.last"
  },
  "references": [
    {
      "url": "https://www.eventbrite.co.uk/e/2-day-project-management-techniques-canterbury-tickets-25314652808",
      "timestamp": "2017-03-22T23:07:15Z"
    }
  ],
  "job_title": {
    "confidence": 0.66,
    "job_title": "Organiser"
  },
  "location": {
    "city": "Kent",
    "country": "United Kingdom"
  },
  "numbers": [
    "+441304244442"
  ]
}

This endpoint retrieves a specific email.

HTTP Request

GET https://emailcrawlr.com/api/v2/email

Query Parameters

Parameter	Required	Description
email	Yes	The email address you want to receive information about.

Find email

curl "https://emailcrawlr.com/api/v2/email/find?full_name=Professional%20Learning&domain=eastkent.ac.uk"
-H "x-api-key: <Your API Key>"

The above command returns JSON structured like this:

{
  "domain": "eastkent.ac.uk",
  "name": "Professional Learning",
  "emails": [
    {
      "email": "[email protected]",
      "personal": false,
      "domain": "eastkent.ac.uk",
      "verified": false,
      "verify": "/v2/email/[email protected]",
      "linkedin": null,
      "twitter": {
        "twitter": "EKCProfessional",
        "confidence": 0.75
      },
      "name": {
        "confidence": 1.0,
        "name": "Professional Learning",
        "pattern": "first.last"
      },
      "references": [
        {
          "url": "https://www.eventbrite.co.uk/e/2-day-project-management-techniques-canterbury-tickets-25314652808",
          "timestamp": "2017-03-22T23:07:15Z"
        }
      ],
      "job_title": {
        "confidence": 0.66,
        "job_title": "Organiser"
      },
      "location": {
        "city": "Kent",
        "country": "United Kingdom"
      },
      "numbers": [
        "+441304244442"
      ]
      "probability": 0.8,
    }
  ]
}

This endpoint tries to find a specific email.

HTTP Request

GET https://emailcrawlr.com/api/v2/email/find

URL Parameters

Parameter	Required	Description
full_name	Yes	The full name, first and last, of the person you are trying to contact.
domain	Yes	The domain name of the person you want to contact.

Verify email

curl "https://emailcrawlr.com/api/v2/email/[email protected]"
-H "x-api-key: <Your API Key>"

The above command returns JSON structured like this:

{
  "mx_set": true,
  "mx_records": [
    {
      "priority": 1,
      "address": "aspmx.l.google.com"
    },
    {
      "priority": 5,
      "address": "alt1.aspmx.l.google.com"
    },
    {
      "priority": 5,
      "address": "alt2.aspmx.l.google.com"
    },
    {
      "priority": 10,
      "address": "mxb.mailgun.org"
    },
    {
      "priority": 10,
      "address": "mxa.mailgun.org"
    },
    {
      "priority": 10,
      "address": "alt4.aspmx.l.google.com"
    },
    {
      "priority": 10,
      "address": "alt3.aspmx.l.google.com"
    }
  ],
  "valid_mx": true,
  "email_sendable": true
  "accepts_all_emails": false
}

This endpoint allows you to verify an emails deliverability.

HTTP Request

GET https://emailcrawlr.com/api/v2/email/verify

URL Parameters

Parameter	Required	Description
email	Yes	The email address you want to verify.

Domains

Get Domain

curl "https://emailcrawlr.com/api/v2/domain?domain=eastkent.ac.uk"
-H "x-api-key: <Your API Key>"

The above command returns JSON structured like this:

{
  "domain": "eastkent.ac.uk",
  "email_pattern": "first.last",
  "location": {
    "city": "Kent",
    "country": "United Kingdom"
  },
  "emails": [
    {
      "email": "[email protected]",
      "personal": false,
      "domain": "eastkent.ac.uk",
      "verified": false,
      "verify": "/v2/email/[email protected]",
      "linkedin": null,
      "twitter": {
        "twitter": "EKCProfessional",
        "confidence": 0.75
      },
      "name": {
        "confidence": 1.0,
        "name": "Professional Learning",
        "pattern": "first.last"
      },
      "references": [
        {
          "url": "https://www.eventbrite.co.uk/e/2-day-project-management-techniques-canterbury-tickets-25314652808",
          "timestamp": "2017-03-22T23:07:15Z"
        }
      ],
      "job_title": {
        "confidence": 0.66,
        "job_title": "Organiser"
      },
      "location": {
        "city": "Kent",
        "country": "United Kingdom"
      },
      "numbers": [
        "+441304244442"
      ]
    }
  ]
}

This endpoint retrieves a specific domain.

HTTP Request

GET https://emailcrawlr.com/api/v2/domain

Query Parameters

Parameter	Required	Description
domain	Yes	The domain name you want information about

Account

Get Account

curl "https://emailcrawlr.com/api/v2/account"
-H "x-api-key: <Your API Key>"

The above command returns JSON structured like this:

{
  "successful_calls": 4,
  "limit": 200,
  "failed_calls": 2,
  "remaining": 196,
}

This endpoint retrieves a your remaining call volume.

HTTP Request

GET https://emailcrawlr.com/api/v2/account

Errors

Error Code	Meaning
400	Bad Request – Incorrect parameters
401	Unauthorized – Your API key is wrong
403	Forbidden – Your account can not query this endpoint.
404	Not Found – The requested resource could not be found.
429	Too Many Requests – You have reached your account limit.
500	Internal Server Error – We had a problem with our server. Try again later.
503	Service Unavailable – We’re temporarily offline for maintenance. Please try again later.