Pipl

Get contact, social, and professional information about people.

Data Enrichment & Threat Intelligence · Pipl

Details

IDPipl
ProviderPipl
CategoryData Enrichment & Threat Intelligence
From Version5.0.0
Supported ModulesAgentix XSIAM

README

Pipl provides a reputation for email addresses and identity solutions.

Configure Pipl in Cortex

Parameter Description Required
url Server URL (e.g., https://api.pipl.com/search/) True
key API Key False
credentials_api_key API Key False
insecure Trust any certificate (not secure) False
proxy Use system proxy settings False
Source Reliability Reliability of the source providing the intelligence data. False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

pipl-search


Search for required query

Base Command

pipl-search

Input

Argument Name Description Required
email Email address to search. Optional
phone Home/work/mobile phone number to search. Optional
username Username/screen-name to search. Minimum 4 characters. Optional
first-name First name to search. Minimum 2 characters. Optional
last-name Last name to search. Minimum 2 characters. Optional
middle-name Middle name or middle initial to search. Optional
raw-name Full name to search. Use this parameter if the accurate name parts (first/middle/last) are not available, this parameter will only be used in absence of first-name and last-name. Optional
country A two-letter country code to searchs. Optional
state A United States, Canada, Great Britain or Australia state code. If a US state is provided and no country specified, we’ll assume the country to be US. Optional
city City to search. Optional
zipcode ZIP code to search. Optional
raw-address Full address to search. Optional
age Age to search in String, an exact (YY) or approximate (YY-YY) age. Optional
columns Order of columns to be displayed in results (comma seperated list of values). Optional

Context Output

Path Type Description
Account.Email.Address unknown Email addresses
Account.IDs unknown User IDs
Account.Addresses unknown Addresses (geographic)
Account.Names unknown Full names
Account.Phones unknown Phone numbers
Account.Usernames unknown Online platforms usernames

email


Searches for information regarding given email address

Base Command

email

Input

Argument Name Description Required
email Email address to search for. Required

Context Output

Path Type Description
Account.Email.Address unknown Email addresses
Account.IDs unknown User IDs
Account.Addresses unknown Addresses (geographic)
Account.Names unknown Full names
Account.Phones unknown Phone numbers
Account.Usernames unknown Online platforms usernames
DBotScore.Indicator String The indicator that was tested.
DBotScore.Score Number The actual DBot score.
DBotScore.Type String The indicator type.
DBotScore.Vendor String The vendor used to calculate the score.
DBotScore.Reliability String Reliability of the source providing the intelligence data.

Configuration parameters

  • url — Server URL (e.g. https://192.168.0.1)
  • key — API Key
  • credentials_api_key
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • integration_reliability — Source Reliability

Commands (2)

  • email

    Searches for information regarding given email address.

  • pipl-search

    Search for required query.

commonfields:
  id: Pipl
  version: -1
name: Pipl
fromversion: 5.0.0
display: Pipl
category: Data Enrichment & Threat Intelligence
provider: Pipl
description: Get contact, social, and professional information about people.
configuration:
- display: Server URL (e.g. https://192.168.0.1)
  name: url
  defaultvalue: https://api.pipl.com/search/
  type: 0
  required: false
- display: API Key
  name: key
  defaultvalue: ""
  type: 4
  hidden: true
  required: false
- displaypassword: API Key
  name: credentials_api_key
  hiddenusername: true
  type: 9
  required: false
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
- additionalinfo: Reliability of the source providing the intelligence data.
  defaultvalue: B - Usually reliable
  display: Source Reliability
  name: integration_reliability
  options:
  - A+ - 3rd party enrichment
  - A - Completely reliable
  - B - Usually reliable
  - C - Fairly reliable
  - D - Not usually reliable
  - E - Unreliable
  - F - Reliability cannot be judged
  type: 15
  required: false
script:
  script: ''
  type: javascript
  commands:
  - name: pipl-search
    arguments:
    - name: email
      description: Email address to search.
    - name: phone
      description: Home/work/mobile phone number to search.
    - name: username
      description: Username/screen-name to search. Minimum 4 characters.
    - name: first-name
      description: First name to search. Minimum 2 characters.
    - name: last-name
      description: Last name to search. Minimum 2 characters.
    - name: middle-name
      description: Middle name or middle initial to search.
    - name: raw-name
      description: Full name to search. Use this parameter if the accurate name parts (first/middle/last) are not available, this parameter will only be used in absence of first-name and last-name.
    - name: country
      description: A two-letter country code to searchs.
    - name: state
      description: A United States, Canada, Great Britain or Australia state code. If a US state is provided and no country specified, we’ll assume the country to be US.
    - name: city
      description: City to search.
    - name: zipcode
      description: ZIP code to search.
    - name: raw-address
      description: Full address to search.
    - name: age
      description: Age to search in String, an exact (YY) or approximate (YY-YY) age.
    - name: columns
      description: Order of columns to be displayed in results (comma seperated list of values).
    outputs:
    - contextPath: Account.Email.Address
      description: Email addresses.
    - contextPath: Account.IDs
      description: User IDs.
    - contextPath: Account.Addresses
      description: Addresses (geographic).
    - contextPath: Account.Names
      description: Full names.
    - contextPath: Account.Phones
      description: Phone numbers.
    - contextPath: Account.Usernames
      description: Online platforms usernames.
    description: Search for required query.
  - name: email
    arguments:
    - name: email
      required: true
      description: Comma separated list of email addresses to search for.
      isArray: true
    outputs:
    - contextPath: Account.Email.Address
      description: Email addresses.
    - contextPath: Account.IDs
      description: User IDs.
    - contextPath: Account.Addresses
      description: Addresses (geographic).
    - contextPath: Account.Names
      description: Full names.
    - contextPath: Account.Phones
      description: Phone numbers.
    - contextPath: Account.Usernames
      description: Online platforms usernames.
    - contextPath: DBotScore.Indicator
      description: The indicator that was tested.
      type: String
    - contextPath: DBotScore.Score
      description: The actual score.
      type: Number
    - contextPath: DBotScore.Type
      description: The indicator type.
      type: String
    - contextPath: DBotScore.Vendor
      description: The vendor used to calculate the score.
      type: String
    - contextPath: DBotScore.Reliability
      type: String
      description: Reliability of the source providing the intelligence data.
    description: Searches for information regarding given email address.
tests:
- No tests