People Data Labs API

naftiko: 1.0.0-alpha2
info:
  label: People Data Labs API
  description: People Data Labs (PDL) provides APIs for enriching and building people and company profiles at scale. The API
    offers person enrichment, person search, person identification, company enrichment, company search, IP enrichment, and
    job posting search across a dataset of professional profiles and organizations.
  tags:
  - People
  - Data
  - Labs
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: people-data-labs
    baseUri: https://api.peopledatalabs.com/v5
    description: People Data Labs API HTTP API.
    authentication:
      type: apikey
      in: header
      name: X-API-Key
      value: '{{PEOPLE_DATA_LABS_TOKEN}}'
    resources:
    - name: person-enrich
      path: /person/enrich
      operations:
      - name: get-person-enrich
        method: GET
        description: Enrich a person profile
        inputParameters:
        - name: email
          in: query
          type: string
        - name: phone
          in: query
          type: string
        - name: profile
          in: query
          type: string
        - name: first_name
          in: query
          type: string
        - name: last_name
          in: query
          type: string
        - name: company
          in: query
          type: string
        - name: min_likelihood
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: person-search
      path: /person/search
      operations:
      - name: get-person-search
        method: GET
        description: Search for person profiles
        inputParameters:
        - name: sql
          in: query
          type: string
        - name: query
          in: query
          type: string
        - name: size
          in: query
          type: integer
        - name: from
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: person-identify
      path: /person/identify
      operations:
      - name: get-person-identify
        method: GET
        description: Identify a person
        inputParameters:
        - name: email
          in: query
          type: string
        - name: phone
          in: query
          type: string
        - name: first_name
          in: query
          type: string
        - name: last_name
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: person-bulk
      path: /person/bulk
      operations:
      - name: post-person-bulk
        method: POST
        description: Bulk person enrichment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: company-enrich
      path: /company/enrich
      operations:
      - name: get-company-enrich
        method: GET
        description: Enrich a company profile
        inputParameters:
        - name: name
          in: query
          type: string
        - name: website
          in: query
          type: string
        - name: profile
          in: query
          type: string
        - name: ticker
          in: query
          type: string
        - name: location
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: company-search
      path: /company/search
      operations:
      - name: get-company-search
        method: GET
        description: Search for companies
        inputParameters:
        - name: sql
          in: query
          type: string
        - name: query
          in: query
          type: string
        - name: size
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ip-enrich
      path: /ip/enrich
      operations:
      - name: get-ip-enrich
        method: GET
        description: IP enrichment
        inputParameters:
        - name: ip
          in: query
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-posting-search
      path: /job_posting/search
      operations:
      - name: get-job-posting-search
        method: GET
        description: Search job postings
        inputParameters:
        - name: sql
          in: query
          type: string
        - name: query
          in: query
          type: string
        - name: size
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: autocomplete
      path: /autocomplete
      operations:
      - name: get-autocomplete
        method: GET
        description: Autocomplete suggestions
        inputParameters:
        - name: field
          in: query
          type: string
          required: true
        - name: text
          in: query
          type: string
        - name: size
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: people-data-labs-rest
    description: REST adapter for People Data Labs API.
    resources:
    - path: /person/enrich
      name: get-person-enrich
      operations:
      - method: GET
        name: get-person-enrich
        description: Enrich a person profile
        call: people-data-labs.get-person-enrich
        outputParameters:
        - type: object
          mapping: $.
    - path: /person/search
      name: get-person-search
      operations:
      - method: GET
        name: get-person-search
        description: Search for person profiles
        call: people-data-labs.get-person-search
        outputParameters:
        - type: object
          mapping: $.
    - path: /person/identify
      name: get-person-identify
      operations:
      - method: GET
        name: get-person-identify
        description: Identify a person
        call: people-data-labs.get-person-identify
        outputParameters:
        - type: object
          mapping: $.
    - path: /person/bulk
      name: post-person-bulk
      operations:
      - method: POST
        name: post-person-bulk
        description: Bulk person enrichment
        call: people-data-labs.post-person-bulk
        outputParameters:
        - type: object
          mapping: $.
    - path: /company/enrich
      name: get-company-enrich
      operations:
      - method: GET
        name: get-company-enrich
        description: Enrich a company profile
        call: people-data-labs.get-company-enrich
        outputParameters:
        - type: object
          mapping: $.
    - path: /company/search
      name: get-company-search
      operations:
      - method: GET
        name: get-company-search
        description: Search for companies
        call: people-data-labs.get-company-search
        outputParameters:
        - type: object
          mapping: $.
    - path: /ip/enrich
      name: get-ip-enrich
      operations:
      - method: GET
        name: get-ip-enrich
        description: IP enrichment
        call: people-data-labs.get-ip-enrich
        outputParameters:
        - type: object
          mapping: $.
    - path: /job_posting/search
      name: get-job-posting-search
      operations:
      - method: GET
        name: get-job-posting-search
        description: Search job postings
        call: people-data-labs.get-job-posting-search
        outputParameters:
        - type: object
          mapping: $.
    - path: /autocomplete
      name: get-autocomplete
      operations:
      - method: GET
        name: get-autocomplete
        description: Autocomplete suggestions
        call: people-data-labs.get-autocomplete
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: people-data-labs-mcp
    transport: http
    description: MCP adapter for People Data Labs API for AI agent use.
    tools:
    - name: get-person-enrich
      description: Enrich a person profile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-person-enrich
      with:
        email: tools.email
        phone: tools.phone
        profile: tools.profile
        first_name: tools.first_name
        last_name: tools.last_name
        company: tools.company
        min_likelihood: tools.min_likelihood
      inputParameters:
      - name: email
        type: string
        description: email
      - name: phone
        type: string
        description: phone
      - name: profile
        type: string
        description: profile
      - name: first_name
        type: string
        description: first_name
      - name: last_name
        type: string
        description: last_name
      - name: company
        type: string
        description: company
      - name: min_likelihood
        type: integer
        description: min_likelihood
      outputParameters:
      - type: object
        mapping: $.
    - name: get-person-search
      description: Search for person profiles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-person-search
      with:
        sql: tools.sql
        query: tools.query
        size: tools.size
        from: tools.from
      inputParameters:
      - name: sql
        type: string
        description: sql
      - name: query
        type: string
        description: query
      - name: size
        type: integer
        description: size
      - name: from
        type: integer
        description: from
      outputParameters:
      - type: object
        mapping: $.
    - name: get-person-identify
      description: Identify a person
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-person-identify
      with:
        email: tools.email
        phone: tools.phone
        first_name: tools.first_name
        last_name: tools.last_name
      inputParameters:
      - name: email
        type: string
        description: email
      - name: phone
        type: string
        description: phone
      - name: first_name
        type: string
        description: first_name
      - name: last_name
        type: string
        description: last_name
      outputParameters:
      - type: object
        mapping: $.
    - name: post-person-bulk
      description: Bulk person enrichment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: people-data-labs.post-person-bulk
      outputParameters:
      - type: object
        mapping: $.
    - name: get-company-enrich
      description: Enrich a company profile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-company-enrich
      with:
        name: tools.name
        website: tools.website
        profile: tools.profile
        ticker: tools.ticker
        location: tools.location
      inputParameters:
      - name: name
        type: string
        description: name
      - name: website
        type: string
        description: website
      - name: profile
        type: string
        description: profile
      - name: ticker
        type: string
        description: ticker
      - name: location
        type: string
        description: location
      outputParameters:
      - type: object
        mapping: $.
    - name: get-company-search
      description: Search for companies
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-company-search
      with:
        sql: tools.sql
        query: tools.query
        size: tools.size
      inputParameters:
      - name: sql
        type: string
        description: sql
      - name: query
        type: string
        description: query
      - name: size
        type: integer
        description: size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-ip-enrich
      description: IP enrichment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-ip-enrich
      with:
        ip: tools.ip
      inputParameters:
      - name: ip
        type: string
        description: ip
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: get-job-posting-search
      description: Search job postings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-job-posting-search
      with:
        sql: tools.sql
        query: tools.query
        size: tools.size
      inputParameters:
      - name: sql
        type: string
        description: sql
      - name: query
        type: string
        description: query
      - name: size
        type: integer
        description: size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-autocomplete
      description: Autocomplete suggestions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-data-labs.get-autocomplete
      with:
        field: tools.field
        text: tools.text
        size: tools.size
      inputParameters:
      - name: field
        type: string
        description: field
        required: true
      - name: text
        type: string
        description: text
      - name: size
        type: integer
        description: size
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    PEOPLE_DATA_LABS_TOKEN: PEOPLE_DATA_LABS_TOKEN