NAV Navbar
Logo
shell

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 "http://api.emailcrawlr.com/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://api.emailcrawlr.com/v2/email

Query Parameters

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

Find email

curl "http://api.emailcrawlr.com/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 http://api.emailcrawlr.com/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 "http://api.emailcrawlr.com/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 http://api.emailcrawlr.com/v2/email/verify

URL Parameters

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

Domains

Get Domain

curl "http://api.emailcrawlr.com/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://api.emailcrawlr.com/v2/domain

Query Parameters

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

Account

Get Account

curl "http://api.emailcrawlr.com/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://api.emailcrawlr.com/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.