Skip to main contentHow to set up People Data Labs
Authentication
People Data Labs uses API key authentication:
- Sign up at peopledatalabs.com
- Navigate to your API dashboard
- Copy your API key
- 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
