Introduction

Welcome to the NioLeads API! You can use our API to access NioLeads API endpoints, which can find email, verify email and fetch contact list.

Rate limit: all endpoints have a concurrent rate limit of 300 simultaneous requests, unless stated otherwise.

Authentication

All authenticated endpoints are requires authentication in the documentation.

You can generate a new API key at our API Tokens on Integration page.

NioLeads expects for the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: Bearer {YOUR_AUTH_KEY}

Business Email

Email Finder

curl --request POST \
    "https://api.nioleads.com/v1/openapi/find_email" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"John Smith\",
    \"domain\": \"example.com\"
}"

The above command returns JSON structured like this:

{
  "name": "John Smith",
  "domain": "example.com",
  "email": "[email protected]"
}

This endpoint find emails from full name and company domain

Find any business email from name and website.

HTTP Request

POST https://api.nioleads.com/v1/openapi/find_email

Body Parameters

Email Verifier

curl --request POST \
    "https://api.nioleads.com/v1/openapi/verify_email" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"[email protected]\"
}"

The above command returns JSON structured like this:

{
  "email": "[email protected]",
  "status": "risky"
}

This endpoint verify an email for potential bounce

HTTP Request

POST https://api.nioleads.com/v1/openapi/verify_email

Body Parameters

Response

Contacts

Get new contact lists

curl "https://api.nioleads.com/v1/openapi/new_contacts"
  -H "Authorization: Bearer YOUR_AUTH_KEY"

The above command returns JSON structured like this:

[
  {
    "id": 1,
    "name": "Tom ********",
    "company": "All We Have Is Now",
    "domain": "allwehaveisnow.co",
    "job_title": "Keynote Speaker",
    "email": "********@allwehaveisnow.co",
    "linkedin_url": "http://www.linkedin.com/in/tomfgoodwin",
    "first_name": "Tom",
    "last_name": "********",
    "city": "New York",
    "region": "New York",
    "country": "United States",
    "industry": "management consulting",
    "company_city": "New York",
    "company_region": "New York",
    "company_country": "United States",
    "company_linkedin_url": "http://www.linkedin.com/company/all-we-have-is-now",
    "list": "Default list"
  }
]

This endpoint retrieve the new added contacts

HTTP Request

GET https://api.nioleads.com/v1/openapi/new_contacts

Errors

The NioLeads API uses the following error codes: