NAV Navbar

Introduction

API endpoint

https://api.comner.io/v1/

Prepare for the new experience and start using our services with our friendly JSON API!
There are three main calls:

Structure

Successful response

{
  "data": {
    ...
  },
  "meta": {
    ...
  }
}

Error response

{
  "errors": {
    ...
  }
}

Cominer’s API is made to make your life easy. There is a simple structure:

Authentication

Please log in to your dashboard to get your API key.

Authentication includes a key which you have to add every time you make a call to our API. If you do not provide the key, an error will occur.
Remember the API key is unique for your account. You can manage your API keys on your dashboard profile.

Errors

When an error occurs, we give you information of what type of errors there were.

Errors example

{
   "errors": [
      {
         "type": "authentication_failed",
         "message": "No API key found"
      },
      {
         "type": "invalid_param",
         "message": "You are missing the full_name parameter"
      }
   ]
}

Domain Search

HTTP request example

GET https://api.cominer.io/v1/domain-search?domain_url=datafeedwatch.com&api_key=YOUR_SECRET_API_KEY

Response: 200 OK

{
   "data": {
      "domain": "datafeedwatch.com",
      "organization": "DataFeedWatch",
      "disposable": false,
      "webmail": false,
      "accept_all": false,
      "pattern": "{first}",
      "emails": [
         {
            "value": "jacques@datafeedwatch.com",
            "type": "personal",
            "sources": [
               {
                  "uri":  "http://datafeedwatch.com/blog/download-all-variants-or-parent-products-only",
                  "extracted_on": "2020-04-25",
                  "last_seen_on": "2020-04-25",
                  "still_on_page": true
               },
               {
                  "uri": "https://www.datafeedwatch.com/contact-us",
                  "extracted_on": "2019-09-24",
                  "last_seen_on": "2020-03-12",
                  "still_on_page": true
               },
               ...
            ]
         },
         ...
      ]
   },
   "meta": {
      "results": 21,
      "limit": 10,
      "offset": 0,
      "params": {
         "domain_url": "datafeedwatch.com",
         "company": null,
         "type": null
      }
   }
}

Domain Search is a tool to help you get a list of email addresses that are behind a website you visit. Type in a domain name or company name and get access to all email addresses using this domain.

domain_url (Required*) Give a domain name.
company (Required*) Give a company name to get a list of its email addresses. Remember that is it always more effective to give a domain name, as it is easier for us to find it.
limit Indicates the number of returned email addresses. It is 10 by default.
offset Indicates the number of skipped email addresses. It is 0 by default.
type You can mark a personal or generic email address.
api_key (Required) Your secret API key. You can generate it in your profile.

Each API call returns up to 100 email addresses if you want to getall of them please use offset parameter.

The number of sources is limited to 20 for each email address. The extracted_on data shows the date when it was first found, while the last_seen_on shows the date when it was last found.

type concerns values personal or generic. A personal refers to email address of someone in the company, while the generic one is a role-based email address, for example help@cominer.io.

confidence helps you decide whether the email address is deliverable. It is expresses in percentage and it is based on several criteria such as the number and quality of sources.

This API call is rate limited to 15 requests per second.

Email Finder

Email Finder is a tool that helps you get a return of a person’s most likely email address you are looking for.

HTTP request example

GET https://api.cominer.io/v1/email-finder?domain_url=datafeedwatch.com&first_name=Jacques&last_name=van+der+Wilt&api_key=YOUR_SECRET_API_KEY

HTTP request example with the company and full_name params

GET https://api.cominer.io/v1/email-finder?company=datafeedwatch.com&full_name=Jacques+van+der+Wilt&api_key=YOUR_SECRET_API_KEY
{
   "data": {
      "email": "jacques@datafeedwatch.com",
      "domain_url": "datafeedwatch.com",
      "company": "DataFeedWatch",
      "accept_all": false,
      "sources": [
         {
            "uri": "http://datafeedwatch.com/contact-us",
            "extracted_on": "2018-03-08",
            "last_seen_on": "2020-04-25",
            "still_on_page": true
         },
         {
            "uri": "http://datafeedwatch.com/blog/white-list-ip-numbers",
            "extracted_on": "2018-03-01",
            "last_seen_on": "2020-04-25",
            "still_on_page": true
         },
        ...
      ]
   },
   "meta": {
      "params": {
         "first_name": "Jacques",
         "last_name": "van der Wilt",
         "full_name": null,
         "domain_url": "datafeedwatch.com"
      }
   }
}
domain_url (Required*) Give a domain name of the company, where this person works. For example “cominer.io”.
company (Required*) Give a company name to get a list of its email addresses. Remember that is it always more effective to give a domain_url, as it is easier for us to find it.
first_name (Required**) Give a person’s first name.
last_name (Required**) Give a person’s last name.
full_name (Required**) Give a person’s first and last name. If you give a person’s full name, you get better results.
api_key (Required) Your secret API key. You can generate it in your profile.

The returned score indicates the probability of the email address correctness.

Email addresses which were found publicly include the source, where they were found.
extracted_on shows the date when it was first found, while the last_seen_on shows the date when it was last found.

This API call is rate limited to 300 requests per minute, with bursts of 10 requests per second.

Email Verifier

Email Verifier is a tool that helps you verify the deliverability of an email address.

HTTP request example

GET https://api.cominer.io/v1/email-verifier?email=jacques@datafeedwatch.com&api_key=YOUR_SECRET_API_KEY
{
   "data":{
      "email":"jacques@datafeedwatch.com",
      "regexp":true,
      "gibberish":false,
      "disposable":false,
      "webmail":false,
      "mx_records":true,
      "smtp_server":true,
      "smtp_check":true,
      "accept_all":false,
      "block":false,
      "sources":[
         {
            "uri":"http://blog.datafeedwatch.com/google-shopping-parent-products-performance",
            "extracted_on":"2018-03-09",
            "last_seen_on":"2020-04-25",
            "still_on_page":true
         },
         {
            "uri":"https://www.datafeedwatch.com/contact-us",
            "extracted_on":"2019-09-24",
            "last_seen_on":"2020-05-19",
            "still_on_page":true
         },
         {
            "uri":"http://blog.datafeedwatch.com/brand-mpn-gtin-product-identifiers-for-google-shopping",
            "extracted_on":"2018-03-04",
            "last_seen_on":"2020-04-25",
            "still_on_page":true
         }
      ]
   },
   "meta":{
      "params":{
         "email":"jacques@datafeedwatch.com"
      }
   }
}
email (Required) Give an email address you want to verify.
api_key (Required) Your secret API key. You can generate it in your profile.

regexp is true if the email address passes our regular expression.

gibberish is true if the email address is automatically generated (for example, “fhgo345@company.com”).

disposable is true if the email address was found on disposable email service.

webmail is true if the email comes from a webmail (for example, Gmail / Yahoo).

mx_records is true if MX records exist on the domain of the email address.

smtp_server is true if we connect to the SMTP server successfully.

smtp_check is true if the email address doesn’t bounce.

accept_all is true if the SMTP server accepts all the email addresses.

block is true if the SMTP server blocked the STMP check.

sources provides information when a given email address was found somewhere on the web. The limit number is 20. extracted_on shows the date when it was first found, while the last_seen_on shows the date when it was last found.

Email Count

HTTP request example

GET https://api.cominer.io/v1/email-count?domain_url=datafeedwatch.com

Response: 200 OK

{
   "data": {
      "total": 21,
      "personal_emails": 13,
      "generic_emails": 8
   },
   "meta": {
      "params": {
         "domain_url": "datafeedwatch.com",
         "type": null
      }
   }
}

Email Count gives you information on how many email addresses of a given domain or the company we have. It is for free and does not require authentication.

domain_url (Required*) Give a domain name.
company (Required*) Give a company name to get a list of its email addresses. Remember that is it always more effective to give a domain name, as it is easier for us to find it.
type You can mark a personal or generic email address.

Account Information

HTTP request example

GET https://api.cominer.io/v1/account?api_key=YOUR_SECRET_API_KEY

Response: 200 OK

{
  "data": {
    "first_name": "Sebastian",
    "last_name": "Tekieli",
    "email": "sebastian@cominer.io",
    "plan_name": "Businness",   
    "reset_date": 2020-04-30,
    "calls": {
      "used": 526,
      "available": 20000
    }
  }
}

It is a tool that gives you information about your account on Cominer.

api_key (Required) Your secret API key. You can generate it in your profile.