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. |