Introduction

Welcome to Leadb API documentation. We provide REST APIs that will allow you to query our database of person data and company data. We have Company API that provides company information based on the criteria you provide and Person API which provides person data.

All our API calls should be made over SSL along with the API key that we provide you and the response is provided in JSON format. For now we support only JSON format.

Please note that the APIs can be accessed only if our team provides you the access to our APIs. To get access you can talk to our sales team and you should adhere to our terms of service and privacy policy. The API access will be revoked if you do not comply with our terms.

Authentication

All the requests are authenticated by your API key. When you make an API call you should pass the API key in the authorization header.

Note that your API key is what identifies you and your usage, so don't share your API key with anyone.

Credits

A credit will be deducted for each successful match. A match is a request that returned results. Duplicate request is also counted and a credit is deducted.

Errors

We use common HTTP response codes to indicate the status of all API requests. In case of an error, our API will returns the appropriate error codes.

200 OK - Successful request

400 Bad request - Badly formatted request

401 Unauthorized - The API key is invalid

403 Too many requests - You've surpassed your usage limits. You may want to contact us and upgrade your plan

404 Not found - The requested endpoint was not found

429 Limit reached - You've reached your trial limit, please contact support for upgrade

5XX Server error - There's some problem on the server side

Person API

The person API lets you look up a person data based on his name and the company, or the domain of the company he works for. For example, you can get the person's location, email and phone number, as well as his or her social network username.

HTTP request

POST https://www.leadb.co/api/person/search -H 'cache-control: no-cache' -H 'content-type: application/json' -d '{ "domain":["leadb.co"], "apiKey":"YOUR_API_KEY"}'

(Where :domain is the domain of the company)

You can opt to get results only in case a phone number or email exist. To do that, add an optional parameter named property.

For cases when you want to get a hit only in case a phone number for the person exists, you should add property=phoneNumbers to your request.

You will be able to look up for a contact with multiple company domains too. You can pass the domains as an array to the Leadb API

POST

curl -X POST https://www.leadb.co/api/person/search -H 'cache-control: no-cache' -H 'content-type: application/json' -d '{ "domain":["leadb.co"], "apiKey":"YOUR_API_KEY"}'

HTTP Parameters
apiKey
Required
For authentication
domain
Required
The domain name (e.g - facebook.com)
HTTP request example

POST https://www.leadb.co/api/person/search
-H 'cache-control: no-cache' -H 'content-type: application/json' -d '{ "domain":["leadb.co"], "apiKey":"YOUR_API_KEY"}'

Response
"data": {
   [
	  {
          email: "john@leadb.co"
	  confidence: "HIGH"
	  firstName: "John"
	  lastName: "Smith"
	  title: "CEO"
	  level: "C-Level"
	  department: "Other"
	  companyName: "Leadb"
	  companyWebsite: "https://www.leadb.co"
	  companyRevenue: "10M - 25M"
	  companyEmployeeCount: "25 - 100"
	  city: "New York"
	  state: "New York"
	  country: "United States"
	  zip: "24322"
	  directPhone: "+1...."
	  companyPhone: "+1...."
	  mobilePhone: "+1111"
	  otherPhone: "+11111"
	  }
   ]
}

Company API

The company API provides the company information like industry, revenue, location, employee count etc. You can lookup for companies by it website domain.

HTTP request

POST

curl -X POST https://www.leadb.co/api/organization/search -H 'cache-control: no-cache' -H 'content-type: application/json' -d '{ "domain":["leadb.co"], "apiKey":"YOUR_API_KEY" }

Where apiKey is your API Key and domain is the domain of the company you're searching for. You can search by multiple domains at a time.

HTTP Parameters
apiKey
Required
Your API key
domain
Required
An array of domains that you want to lookup for
Response
"data": {
   [
	  {
          name:"Leadb",
	  domain:"leadb.co"
	  revenue: "10M - 25M"
	  employeeCoun: "25 - 100"
	  city: "New York"
	  state: "New York"
	  country: "United States"
	  zip: "24322",
	  facebook:"http"//facebook.com/leadb",
	  twitter:"twitter.com/leadb",
	  linkedin:"linkedin.com/company/leadb"
	  }
   ]
}