polymerdao/polymer-pay-peopledatalabs

People Data Labs

People Data Labs provides access to the world's largest people and company dataset. Enrich, search, and clean person, company, school, location, job title, and IP data through the Polymer Pay proxy.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/x402.orth.sh/peopledatalabs

Common Operations

Enrich Person

Enrich a person by name, email, phone, LinkedIn URL, or other identifiers.

Pricing: $0.35

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/peopledatalabs/v5/person/[email protected]&pretty=true",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: Full profile with work history, education, skills, and social profiles.

Query Parameters:

• name: Full name (e.g., "Jennifer C. Jackson")
• first_name: First name
• last_name: Last name
• email: Email address
• phone: Phone number
• lid: LinkedIn ID or URL
• profile: Social profile URL
• company: Current company name
• location: Location string
• min_likelihood: Minimum match confidence (1-10, default: 2)

Identify Person

Broad person lookup returning up to 20 candidate matches with confidence scores.

Pricing: $0.70

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/peopledatalabs/v5/person/identify?name=John%20Doe&company=Google&pretty=true",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Search People

Search and filter people using Elasticsearch or SQL queries.

Pricing: $0.35

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/peopledatalabs/v5/person/search?pretty=true",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "sql": "SELECT * FROM person WHERE job_title='Software Engineer' AND location_country='united states' LIMIT 10"
  }
}

Enrich Company

Enrich a company by name, website, ticker, or LinkedIn URL.

Pricing: $0.11

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/peopledatalabs/v5/company/enrich?website=stripe.com&pretty=true",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Search Companies

Search and filter companies using Elasticsearch or SQL queries.

Pricing: $0.11

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/peopledatalabs/v5/company/search?pretty=true",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "sql": "SELECT * FROM company WHERE industry='software' AND size='51-200' LIMIT 10"
  }
}

Enrich IP Address

Enrich an IP address with associated company, location, and metadata.

Pricing: $0.09

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/peopledatalabs/v5/ip/enrich?ip=8.8.8.8&pretty=true",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

When to Use

• Person enrichment — Add work history, education, skills from email/LinkedIn
• Company enrichment — Get industry, size, funding, location from domain
• Prospect search — Find people by job title, company, location with SQL queries
• Account research — Find companies by industry, size, funding stage
• IP intelligence — Identify companies from website visitor IP addresses
• Data cleansing — Verify and standardize person/company records
• Identity resolution — Match partial info to full profiles with confidence scores

Best Practices

• Use multiple identifiers — Include name, email, LinkedIn for better match rates
• Set min_likelihood — Adjust confidence threshold (1-10) based on use case
• Use SQL queries — Powerful filtering with familiar SQL syntax
• Pagination — Use size and from parameters for large result sets
• Pretty print — Add pretty=true for readable JSON during development
• Handle nulls — Some fields may be null; design for partial data
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting