Skip to main content

How to use API to fetch contacts automatically?

How to use Contacts API to fetch direct dials of the top management automatically without using Mr. E extension

E
Written by EasyLeadz Support
Updated over 2 weeks ago

Mr. E API makes it easy for you bulk enrich or fetch contact numbers of decision makers automatically.

You can use the API to integrate with your CRM tools or create your own custom applications and fetch the contact numbers using the API.

End point (GET Request)

Pass the data in json encoded form in following format e.g. {'data':{'url':"xxxxxxxxxx","email":"xxx@xxx.com","callbackUrl":"https://www.yourwebhookurl.com"}}

Either linkedin url or email id is required by the API. If user sends both only linkedin url will be considered.


​API KEY

Pass your api key as value for header Enapi-Key

Enapi-Key: your-api-key

Additional Headers

You must also specify additional headers Content-type: application/json and Accept: application/json

Curl example

curl --location "https://app.easyleadz.com/api/prod/" --header "Enapi-Key: your-api-key" --header "Content-Type: application/json" --data-raw "{\"data\":{\"url\":\"https://www.linkedin.com/in/xxxxxxxx\",\"email\":\"xxx@xxx.com\",\"callbackUrl\":\"https://www.yourdomain.com/callbackurl\"}}"

Response

Credits Deductions

Credits will only be deducted if phone number is found.

Response Key

Response Value

Description

Status

"1" or "0"

"1" for success and "0" for error

Message

"Done" or "Error message"

In case of success the value will be "Done" in case of error the value will be reason for error(more error details are mentioned below)

Data

The data field will contain the data that was posted to the api along with unique request_id , this request_id will be send back to the callbackUrl with contact data.

Error message

Error value

Description

Invalid key. Please enter correct key

This error message is received if no api key is passed or invalid key is passed.

Please enter a valid linkedin profile url. Api do not support sales navigator url

This error message is received if the linkedin profile url is not in correct format (https://www.linkedin.com/in/xxxxxxxx).

Please provide valid email id

If email id passed is not in correct format.

Please provide a call back url

If callbackUrl is not passed or is empty.

Please provide linkedin url or email address

If both linkedin url and email are not passed. User needs to send either one of them.

Contact Data

End point (POST Request) The contact response is posted to callbackUrl provided in request api mentioned above. Credits are only deducted if there data value for phone1 is not empty. Data is posted in json format.

Response(sample) {"data":{"phone1":"xxxxx","phone2":"xxxx","email":["xxx@xxx.com"],"request_id":"6763d2c03cd23-173459526410037765"},"error":""}

Response Key

Response Value

Description

Status

"1" or "0"

"1" for success and "0" for error

Message

"Done" or "Error message"

In case of success the value will be "Done" in case of error the value will be reason for error(more error details are mentioned below)

Data

{"data":{"phone1":"xxxxx","phone2":"xxxx","email":["xxx@xxx.com"],"request_id":"6763d2c03cd23-173459526410037765"},"error":""}

This contains the enriched data will following fields
phone1 = value of phone number or ""
phone2 = value of additional phone number or ""
email = array containing email ids or empty array ([])
request_id = The request id recieved during initial post request
error = In case there was an error while processing the request, this will contain the detailed error message.
​

Error message

Error value

Description

Invalid api key

This error message is received if no api key is passed or invalid key is passed.

No credits left

This error message is received if there are no credits left.

Invalid url

If linkedin url was not in correct format.

Support

Who can get access to the API?

API is only available in the HYPERGROWTH plan or customised plan. If you need access to the API please email to support@easyleadz.com

Once your access is granted then you will have access to this page, which contains your unique API Key as well as technical information and the end point information.

Rate Limit
​
The rate limit is 10 calls per second.

Did this answer your question?