> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# People Data Labs

> Integration details and setup guide for the People Data Labs connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                   |
| ----------------------------------- | ------------------------- |
| **Authentication**                  | API Key (Query Parameter) |
| **Two-Way Sync**                    | No                        |
| **Events Supported**                | No                        |
| **Realtime**                        | Polling                   |
| **Supports Rate Limiting**          | Yes                       |
| **Authentication Scopes Supported** | N/A (API Key)             |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **People Data Labs**:

* **Person Data**
* **Company Data**
* **Job Titles**
* **Skills**
* **Contact Information**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                     |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Yes. People Data Labs offers a free tier with limited API calls. [Sign up for free](https://www.peopledatalabs.com/signup) |
| **Requires paid sandbox?**                         | No. You can use the free tier for testing and development.                                                                 |
| **Requires partnership to obtain authentication?** | No. Anyone can sign up for a People Data Labs account and get API access.                                                  |

***

### Authentication (API Key)

For customers who want to completely whitelabel their authentication experience, you can provide your own developer keys instead of using Alloy Automation's.

<steps>
  <step title="Create People Data Labs Account">
    Sign up for an account at [https://www.peopledatalabs.com](https://www.peopledatalabs.com) or log in to your existing account
  </step>

  <step title="Access API Keys">
    1. Navigate to your account dashboard
    2. Go to **Settings** or **API Keys** section
    3. You should see your API key displayed
  </step>

  <step title="Generate or Copy API Key">
    1. If you don't have an API key, click **Generate API Key**
    2. Copy the API key provided
    3. Store it securely (the key provides access to your account and data credits)
  </step>

  <step title="Configure in Alloy Automation">
    1. In Alloy Automation, enter your People Data Labs API key
    2. The key will be sent as the `api_key` query parameter in all API requests
    3. Test the connection to verify authentication
  </step>
</steps>

For comprehensive API documentation, visit [People Data Labs API Docs](https://docs.peopledatalabs.com/).

***

## Use Cases

### 1) Contact enrichment for sales

Enrich lead and contact records in your CRM with professional information from People Data Labs, including job titles, company details, skills, and social profiles to improve sales targeting.

### 2) Candidate sourcing automation

Automatically search for potential candidates based on skills, job titles, and company criteria using People Data Labs' person search API to build recruitment pipelines.

### 3) Lead scoring and qualification

Use enriched data from People Data Labs to automatically score and qualify leads based on job role, company size, industry, and other professional attributes for better sales prioritization.

### 4) Market research and analysis

Pull company and employee data from People Data Labs to conduct market research, competitive analysis, and identify trends in specific industries or geographic regions.

### 5) Account-based marketing

Enrich target account data with employee information from People Data Labs to identify key decision-makers and personalize outreach campaigns for account-based marketing strategies.

***

## API Gotchas

* **Credit consumption:** Each API call consumes credits from your account balance. Monitor your credit usage carefully and implement caching to avoid unnecessary API calls for the same data.

* **Rate limiting:** People Data Labs enforces rate limits based on your plan tier. Implement exponential backoff retry logic to handle rate limit errors gracefully.

* **Data freshness:** Person and company data may not always be current. Always verify critical information before using it for important decisions or outreach.

* **Query parameters:** API keys are passed as query parameters (`api_key=YOUR_KEY`). Ensure your HTTP client properly encodes URLs and handles query parameters securely.

* **Partial matches:** Search APIs may return partial matches. Always validate returned data matches your search criteria before using it in downstream processes.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.