NAV Navigation
shell

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://v2.nioleads.com/api/openapi/find_email" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"firstname\": \"John\",
    \"lastname\": \"Smith\",
    \"domainOrCompany\": \"example.com\"
}"

The above command returns JSON structured like this:

{
  "status": "found",
  "email": "[email protected]",
  "message": "Email found"
}

This endpoint find emails from full name and company domain

Find any business email from name and website.

HTTP Request

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

Body Parameters

Parameter Required Description
firstname true Person’s first name
lastname true Person’s last name
domainOrCompany true Email domain or Company name

Account

Get Credits

curl --request GET \
    "https://v2.nioleads.com/api/openapi/credits" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Accept: application/json"

The above command returns JSON structured like this:

{
  "status": "success",
  "data": {
    "total_credits": 1000
  }
}

This endpoint retrieves the current credit balance for your account.

Get your current available credits balance.

HTTP Request

GET https://v2.nioleads.com/api/openapi/credits

Errors

The NioLeads API uses the following error codes:

Error Code Meaning
400 Bad Request – Your request is invalid.
401 Unauthorized – Your API key is wrong or expired.
404 Not Found – The specified data could not be found.
429 Too Many Requests – You’re requesting too many data! Slow down!
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.
shell