People Data Labs

opencollection: 1.0.0
info:
  name: People Data Labs API
  version: '5.0'
request:
  auth:
    type: apikey
    apikey:
      in: header
      key: X-Api-Key
      value: '{{apiKey}}'
items:
- info:
    name: Person
    type: folder
  items:
  - info:
      name: Person Enrichment.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/person/enrich?profile=linkedin.com/in/seanthorne
      params:
      - name: profile
        value: linkedin.com/in/seanthorne
        type: query
        description: A social profile URL used as an identifying attribute.
    docs: Returns the single best-matching person profile for a set of identifying attributes (name, email, phone, profile,
      company).
  - info:
      name: Bulk Person Enrichment.
      type: http
    http:
      method: POST
      url: https://api.peopledatalabs.com/v5/person/bulk
      body:
        type: json
        data: "{\n  \"requests\": [\n    { \"params\": { \"profile\": \"linkedin.com/in/seanthorne\" } }\n  ]\n}"
    docs: Enriches up to 100 person records in a single request.
  - info:
      name: Person Identify.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/person/identify?name=sean thorne
      params:
      - name: name
        value: sean thorne
        type: query
        description: A broadly identifying attribute.
    docs: Returns a ranked selection of candidate profiles for broadly identifying inputs.
  - info:
      name: Person Search.
      type: http
    http:
      method: POST
      url: https://api.peopledatalabs.com/v5/person/search
      body:
        type: json
        data: "{\n  \"query\": { \"bool\": { \"must\": [ { \"term\": { \"job_company_name\": \"people data labs\" } } ] }\
          \ },\n  \"size\": 10\n}"
    docs: Finds all profiles satisfying an Elasticsearch or SQL query.
  - info:
      name: Retrieve Person by ID.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/person/retrieve/:person_id
      params:
      - name: person_id
        value: ''
        type: path
        description: The PDL person id.
    docs: Retrieves a specific person record by its PDL id.
  - info:
      name: Bulk Person Retrieve.
      type: http
    http:
      method: POST
      url: https://api.peopledatalabs.com/v5/person/retrieve/bulk
      body:
        type: json
        data: "{\n  \"requests\": [ { \"id\": \"qEnOZ5Oh0poWnQ1luFBfVw_0000\" } ]\n}"
    docs: Retrieves multiple person records by PDL id in one request.
- info:
    name: Company
    type: folder
  items:
  - info:
      name: Company Enrichment.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/company/enrich?website=peopledatalabs.com
      params:
      - name: website
        value: peopledatalabs.com
        type: query
        description: A company website domain used as an identifier.
    docs: Resolves a company from a website, LinkedIn URL, or name and returns firmographic data.
  - info:
      name: Company Search.
      type: http
    http:
      method: POST
      url: https://api.peopledatalabs.com/v5/company/search
      body:
        type: json
        data: "{\n  \"query\": { \"bool\": { \"must\": [ { \"term\": { \"industry\": \"computer software\" } } ] } },\n  \"\
          size\": 10\n}"
    docs: Finds all companies matching an Elasticsearch or SQL query.
- info:
    name: Cleaner and Utilities
    type: folder
  items:
  - info:
      name: Company Cleaner.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/company/clean?name=peopledatalabs
      params:
      - name: name
        value: peopledatalabs
        type: query
        description: A raw company name to standardize.
    docs: Standardizes and enriches a raw company name, website, or profile.
  - info:
      name: School Cleaner.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/school/clean?name=university of oregon
      params:
      - name: name
        value: university of oregon
        type: query
        description: A raw school name to standardize.
    docs: Standardizes and enriches a raw school name or profile.
  - info:
      name: Location Cleaner.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/location/clean?location=san francisco ca
      params:
      - name: location
        value: san francisco ca
        type: query
        description: A raw location string to standardize.
    docs: Standardizes and geocodes a raw location string.
  - info:
      name: Job Title Enrichment.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/job_title/enrich?job_title=software engineer
      params:
      - name: job_title
        value: software engineer
        type: query
        description: A job title to enrich with related metadata.
    docs: Returns related titles, levels, and role metadata for a job title.
  - info:
      name: Skill Enrichment.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/skill/enrich?skill=python
      params:
      - name: skill
        value: python
        type: query
        description: A skill to enrich with related skills.
    docs: Returns related and similar skills for a given skill.
  - info:
      name: Autocomplete.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/autocomplete?field=company&text=goog
      params:
      - name: field
        value: company
        type: query
        description: The schema field to autocomplete.
      - name: text
        value: goog
        type: query
        description: The partial text to complete.
    docs: Returns typeahead suggestions and counts for a schema field.
  - info:
      name: IP Enrichment.
      type: http
    http:
      method: GET
      url: https://api.peopledatalabs.com/v5/ip/enrich?ip=72.212.42.169
      params:
      - name: ip
        value: 72.212.42.169
        type: query
        description: An IP address to enrich with company and location data.
    docs: Enriches an IP address with associated company and location intelligence.
bundled: true