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

# People Data Labs

> Connect People Data Labs for comprehensive person and company data enrichment and search.

## How to set up People Data Labs

### Authentication

People Data Labs uses API key authentication:

1. Sign up at [peopledatalabs.com](https://peopledatalabs.com)
2. Navigate to your API dashboard
3. Copy your API key
4. Paste the API key in Cargo when connecting

## People Data Labs actions

### Enrich person

Get comprehensive profile data for a person.

**Input parameters (provide as many as available):**

* **Name / First name / Last name**: Person's name
* **Email / Email hash**: Email address
* **Phone**: Phone number
* **Company / School**: Employment or education
* **Profile / LinkedIn ID**: Social profile URL or ID
* **Location / Country / Region**: Geographic data
* **PDL ID**: People Data Labs ID (if known)

**Options:**

* **Data include**: Select specific fields to return
* **Min likelihood**: Minimum confidence threshold
* **Titlecase**: Return titlecased text

**Credits:** 3 credits per request

### Enrich company

Get detailed company information.

**Input parameters:**

* **PDL ID**: People Data Labs company ID
* **Name**: Company name
* **Website / Profile**: Company website or LinkedIn
* **Ticker**: Stock ticker symbol
* **Location details**: Address, city, region, country

**Credits:** 3 credits per request

### Search people

Find people matching specific criteria using filters.

**Configuration:**

* **Filter**: Build complex filter conditions
* **Limit**: Maximum results to return
* **Titlecase / Pretty**: Output formatting

**Credits:** 3 credits per result

### Search companies

Find companies matching specific criteria.

**Configuration:**

* **Filter**: Build filter conditions
* **Limit**: Maximum results to return

**Credits:** 3 credits per result

### Query people

Search people using SQL-like queries.

**Required fields:**

* **Query**: SQL query (e.g., `SELECT * FROM people WHERE ...`)
* **Limit**: Maximum results

**Credits:** 3 credits per result

**Use case:** Complex queries with full SQL flexibility.

### Query companies

Search companies using SQL-like queries.

**Required fields:**

* **Query**: SQL query for companies
* **Limit**: Maximum results

**Credits:** 3 credits per result

## People Data Labs data models

### Fetch people

Pull people matching criteria into Cargo.

**Configuration:**

* **Filter**: Define matching criteria
* **Limit**: Maximum records

**Features:**

* Unifies contacts by email, LinkedIn ID
* Credits charged per result

### Fetch companies

Pull companies matching criteria into Cargo.

**Configuration:**

* **Filter**: Define matching criteria
* **Limit**: Maximum records

**Features:**

* Unifies accounts by domain, LinkedIn
* Credits charged per result

## Credits summary

| Action           | Credits      |
| ---------------- | ------------ |
| Enrich person    | 3 (fixed)    |
| Enrich company   | 3 (fixed)    |
| Search people    | 3 per result |
| Search companies | 3 per result |
| Query people     | 3 per result |
| Query companies  | 3 per result |
| Fetch people     | 3 per result |
| Fetch companies  | 3 per result |

## Rate limits

People Data Labs API has a rate limit of 100 requests per minute. Cargo handles rate limiting automatically.

## Best practices

* Provide multiple identifiers for better matching
* Use min\_likelihood to filter low-confidence matches
* Start with search to find IDs, then enrich for full data
* Use SQL queries for complex, custom filtering
* Cache enrichment results to avoid duplicate lookups