People Data Labs JavaScript Library

JavaScript client with TypeScript support for the People Data Labs API.

This is a simple JavaScript client library to access the various API endpoints provided by People Data Labs.

This library bundles up PDL API requests into simple function calls, making it easy to integrate into your projects. You can use the various API endpoints to access up-to-date, real-world data from our massive Person and Company Datasets.

✨ Features

Supports all People Data Labs API endpoints
Built-in Typescript support

🔧 Installation

Pull the package from the npm repository:

yarn add peopledatalabs

or

npm i peopledatalabs

If you get a error while running a typescript project, add "esModuleInterop": true to your tsconfig
Sign up for a free PDL API key

🚀 Usage

First, create the PDLJS client:

import PDLJS from 'peopledatalabs';

const PDLJSClient = new PDLJS({ apiKey: 'YOUR API KEY' })

Then, send requests to any PDL API Endpoint:

Using Person APIs

// By Enrichment
try {
  const response = await PDLJSClient.person.enrichment({ phone: '4155688415' });

  console.log(response);
} catch (error) {
  console.log(error);
}

// By Preview Enrichment
try {
  const response = await PDLJSClient.person.enrichmentPreview({ phone: '4155688415' });

  console.log(response);
} catch (error) {
  console.log(error);
}

// By Bulk Enrichment
const bulkEnrichmentRecords = {
  requests: [
    {
      params: {
        profile: ['linkedin.com/in/seanthorne'],
      },
    },
    {
      params: {
        profile: ['linkedin.com/in/randrewn'],
      },
    },
  ],
};

try {
  const response = await PDLJSClient.person.bulk.enrichment(bulkEnrichmentRecords);

  console.log(response.items);
} catch (error) {
  console.log(error);
}

// By Search (SQL)
const sqlQuery = "SELECT * FROM person WHERE location_country='mexico' AND job_title_role='health'AND phone_numbers IS NOT NULL;"

try {
  const response = await PDLJSClient.person.search.sql({ searchQuery: sqlQuery, size: 10 });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

// By Search (Elasticsearch)
const esQuery = {
  query: {
    bool: {
      must:[
        { term: { location_country: 'mexico' } },
        { term: { job_title_role: 'health' } },
        { exists: { field: 'phone_numbers' } }
      ]
    }
  }
}

try {
  const response = await PDLJSClient.person.search.elastic({ searchQuery: esQuery, size: 10 });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

// By Fuzzy Enrichment
try {
  const response = await PDLJSClient.person.identify({ name: 'sean thorne' });

  console.log(response);
} catch (error) {
  console.log(error);
}

Using Company APIs

// By Enrichment
try {
  const response = await PDLJSClient.company.enrichment({ website: 'peopledatalabs.com' });

  console.log(response);
} catch (error) {
  console.log(error);
}

// By Bulk Enrichment
const bulkEnrichmentRecords = {
  requests: [
    {
      params: {
        profile: ['linkedin.com/in/peopledatalabs'],
      },
    },
    {
      params: {
        profile: ['linkedin.com/in/apple'],
      },
    },
  ],
};

try {
  const response = await PDLJSClient.company.bulk.enrichment(bulkEnrichmentRecords);

  console.log(response.items);
} catch (error) {
  console.log(error);
}

// By Search (SQL)
const sqlQuery = "SELECT * FROM company WHERE tags='big data' AND industry='financial services' AND location.country='united states';"

try {
  const response = await PDLJSClient.company.search.sql({ searchQuery: sqlQuery, size: 10 });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

// By Search (Elasticsearch)
const esQuery = {
  query: {
    bool: {
      must:[
        { term: { tags: 'big data' } },
        { term: { industry: 'financial services' } },
        { term: { location_country: 'united states' } }
      ]
    }
  }
}

try {
  const response = await PDLJSClient.company.search.elastic({ searchQuery: esQuery, size: 10 });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

Using Autocomplete API

// Get Autocomplete Suggestions
try {
  const response = await PDLJSClient.autocomplete({ field: 'title', text: 'full', size: 10 });

  console.log(response);
} catch (error) {
  console.log(error);
}

Using Cleaner APIs

// Clean Raw Company Strings
try {
  const response = await PDLJSClient.company.cleaner({ name: 'peOple DaTa LabS' });

  console.log(response);
} catch (error) {
  console.log(error);
}

// Clean Raw Location Strings
try {
  const response = await PDLJSClient.location.cleaner({ location: '455 Market Street, San Francisco, California 94105, US' });

  console.log(response);
} catch (error) {
  console.log(error);
}

// Clean Raw School Strings
try {
  const response = await PDLJSClient.school.cleaner({ name: 'university of oregon' });

  console.log(response);
} catch (error) {
  console.log(error);
}

Using Job Title Enrichment API

// Enrich a Job Title
try {
  const response = await PDLJSClient.jobTitle({ jobTitle: 'software engineer' });

  console.log(response);
} catch (error) {
  console.log(error);
}

Using Skill Enrichment API

// Enrich a Skill
try {
  const response = await PDLJSClient.skill({ skill: 'c++' });

  console.log(response);
} catch (error) {
  console.log(error);
}

Using IP Enrichment API

// Enrich an IP Address
try {
  const response = await PDLJSClient.ip({ ip: '72.212.42.169' });

  console.log(response);
} catch (error) {
  console.log(error);
}

Using Sandbox APIs

// By Person Enrichment
try {
  const response = await PDLJSClient.person.enrichment({
    email: 'reneewillis74@aol.com',
    sandbox: true,
  });

  console.log(response);
} catch (error) {
  console.log(error);
}

// By Person Search (SQL)
try {
  const response = await PDLJSClient.person.search.sql({
    searchQuery: "SELECT * FROM person WHERE location_country='united states';",
    size: 10,
    sandbox: true,
  });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

// By Person Search (Elasticsearch)
const esQuery = {
  query: {
    bool: {
      must:[
        { term: { location_country: 'united states' } }
      ]
    }
  }
}

try {
  const response = await PDLJSClient.person.search.elastic({ searchQuery: esQuery, size: 10, sandbox: true });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

// By Person Fuzzy Enrichment
try {
  const response = PDLJSClient.person.identify({ email: 'reneewillis74@aol.com', sandbox: true });

  console.log(response);
} catch (error) {
  console.log(error);
}

// By Company Enrichment
try {
  const response = await PDLJSClient.company.enrichment({ website: 'kohlerinteriors.com', sandbox: true });

  console.log(response);
} catch (error) {
  console.log(error);
}

// By Company Search (SQL)
const sqlQuery = "SELECT * FROM company WHERE tags='hotel consultant' AND industry='hospitality';"

try {
  const response = await PDLJSClient.company.search.sql({ searchQuery: sqlQuery, size: 10, sandbox: true });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

// By Company Search (Elasticsearch)
const esQuery = {
  query: {
    bool: {
      must:[
        { term: { tags: 'hotel consultant' } },
        { term: { industry: 'hospitality' } }
      ]
    }
  }
}

try {
  const response = await PDLJSClient.company.search.elastic({ searchQuery: esQuery, size: 10, sandbox: true });

  console.log(response.total);
} catch (error) {
  console.log(error);
}

🌐 Endpoints

Person Endpoints

API Endpoint	PDLJS Function
Person Enrichment API	`PDLJS.person.enrichment({ ...params })`
Person Preview Enrichment API	`PDLJS.person.enrichmentPreview({ ...params })`
Person Bulk Person Enrichment API	`PDLJS.person.bulk.enrichment({ ...records })`
Person Search API	SQL: `PDLJS.person.search.sql({ ...params })` Elasticsearch: `PDLJS.person.search.elastic({ ...params })`
Person Identify API	`PDLJS.person.identify({ ...params })`

Company Endpoints

API Endpoint	PDLJS Function
Company Enrichment API	`PDLJS.company.enrichment({ ...params })`
Company Bulk Enrichment API	`PDLJS.company.bulk.enrichment({ ...records })`
Company Search API	SQL: `PDLJS.company.search.sql({ ...params })` Elasticsearch: `PDLJS.company.search.elastic({ ...params })`

Supporting Endpoints

API Endpoint	PDLJS Function
Autocomplete API	`PDLJS.autocomplete({ ...params })`
Company Cleaner API	`PDLJS.company.cleaner({ ...params })`
Location Cleaner API	`PDLJS.location.cleaner({ ...params })`
School Cleaner API	`PDLJS.school.cleaner({ ...params })`
Job Title Enrichment API	`PDLJS.jobTitle({ ...params })`
Skill Enrichment API	`PDLJS.skill({ ...params })`
IP Enrichment API	`PDLJS.ip({ ...params })`

Sandbox Endpoints

API Endpoint	PDLJS Function
Person Enrichment Sandbox API	`PDLJS.person.enrichment({ ...params, sandbox: true })`
Person Search Sandbox API	SQL: `PDLJS.person.search.sql({ ...params, sandbox: true })` Elasticsearch: `PDLJS.person.search.elastic({ ...params, sandbox: true })`
Person Identify Sandbox API	`PDLJS.person.identify({ ...params, sandbox: true })`
Company Enrichment Sandbox API	`PDLJS.company.enrichment({ ...params, sandbox: true })`
Company Search Sandbox API	SQL: `PDLJS.company.search.sql({ ...params, sandbox: true })` Elasticsearch: `PDLJS.company.search.elastic({ ...params, sandbox: true })`

📘 Documentation

All of our API endpoints are documented at: https://docs.peopledatalabs.com/

These docs describe the supported input parameters, output responses and also provide additional technical context.

As illustrated in the Endpoints section above, each of our API endpoints is mapped to a specific method in the PDLJS class. For each of these class methods, all function inputs are mapped as input parameters to the respective API endpoint, meaning that you can use the API documentation linked above to determine the input parameters for each endpoint.

As an example:

The following is valid because name is a supported input parameter to the Person Identify API:

PDLJS.person.identify({ name: 'sean thorne' })

Conversely, this would be invalid because fake_parameter is not an input parameter to the Person Identify API:

PDLJS.person.identify({ fake_parameter: 'anything' })

Special Note about Search API Support

Our Person Search API and Company Search API endpoints both support two types of query syntax: you can construct search queries using either SQL or Elasticsearch syntax.

In the PDLJS class, the person and company search functions are broken out into two syntax-specific methods as follows:

Data Type	Search Query Syntax	Function
Person	SQL	`PDLJS.person.search.sql({ ...params })`
Person	Elasticsearch	`PDLJS.person.search.elastic({ ...params })`
Company	SQL	`PDLJS.company.search.sql({ ...params })`
Company	Elasticsearch	`PDLJS.company.search.elastic({ ...params })`

You can pass your query to these methods using the special searchQuery function argument, as shown in the following example:

const sqlQuery = "SELECT * FROM company WHERE website='peopledatalabs.com';"

try {
  const response = await PDLJS.company.search.sql({ searchQuery: sqlQuery, size: 10 });

  console.log(response.total)
} catch (error) {
  console.log(error)
}

Upgrading to v6.X.X

NOTE: When upgrading to v6.X.X from vX.X.X and below, Retrieve and Bulk Retrieve were both changed to make the pretty, titlecase and filter_updated to be siblings of the requests parameter.

Upgrading to v5.X.X

NOTE: When upgrading to v5.X.X from v4.X.X and below, Bulk Enrichment was moved from PDLJS.person.bulk({ ...records }) to PDLJS.person.bulk.enrichment({ ...records })

Name		Name	Last commit message	Last commit date
Latest commit History 177 Commits
.github		.github
example		example
src		src
tests		tests
.env.local.example		.env.local.example
.eslintrc.cjs		.eslintrc.cjs
.gitignore		.gitignore
.ncurc.json		.ncurc.json
LICENSE		LICENSE
README.md		README.md
package.json		package.json
tsconfig.eslint.json		tsconfig.eslint.json
tsconfig.json		tsconfig.json
yarn.lock		yarn.lock

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

People Data Labs JavaScript Library

✨ Features

Table of Contents

🔧 Installation

🚀 Usage

🌐 Endpoints

📘 Documentation

Special Note about Search API Support

Upgrading to v6.X.X

Upgrading to v5.X.X

About

Releases 65

Contributors 9

Languages

License

peopledatalabs/peopledatalabs-js

Folders and files

Latest commit

History

Repository files navigation

People Data Labs JavaScript Library

✨ Features

Table of Contents

🔧 Installation

🚀 Usage

🌐 Endpoints

📘 Documentation

Special Note about Search API Support

Upgrading to v6.X.X

Upgrading to v5.X.X

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 65

Contributors 9

Languages