API Fields

The following are the list of attributes that can used to filter the People data

• filters in Factori APIs help you provide filters based on which you will be receiving data of individuals
• output_fields in Factori Unlock API help you receive only those attributes that are useful to you instead of receiving all attributes in the response. For example, "output_fields": ["social", "phone"] means to say that if a record matches a given criteria return only the social info and the phone info.
• must_contain in Factori APIs help you in fetching a specific record if and only if a value exists for that key. For example, "must_contain": "email" means to say that the API needs to fetch a record only if the record contains values for phone numbers and emails
  • must_not_contain in Factori APIs help you exclude people based on some criteria. In the below example the API response will exclude People with a "people_id": "123"

"must_not_contain": {
	"people_id": ["123"]
}

• page_no in Factori APIs will help you navigate the response using pagination
• All emails are lowercase and empty spaces are trimmed before hashing.
• All phone numbers have their extensions trimmed and don't have any hyphen (-) . Also empty spaces are trimmed before hashing. Our inputs accept phone numbers without extensions, spaces and hyphens.
• All maids end are lowercase and empty spaces are trimmed before hashing.
• Factori APIs accept full_address in the standard format specified by the USPS.
• Any address_suffix mentioned in the address should be as present in - https://pe.usps.com/text/pub28/28apc_002.htm
• Factori APIs accept only abbreviations for States as mentioned in - https://about.usps.com/who/profile/history/state-abbreviations.htm
• Factori APIs accept "Male" and "Female" as values for gender.
• Factori APIs follow standard SIC codes as mentioned in https://www.sec.gov/corpfin/division-of-corporation-finance-standard-industrial-classification-sic-code-list
• Factori APIs follow standard NAICS codes as mentioned in https://www.census.gov/naics/?58967?yearbck=2022
• net_worth field in Factori APIs accept the following ranges for filtering based on an individual's net worth

• household_income field in Factori APIs accept the following ranges

Here is the table showing different credit rating range

Here is the table showing how employee level are represented:

Here is the table with the serial number and address directions:

Types

1. Search

The People Search API is your tool for exploring our People database. It allows you to discover and build highly targeted contact lists based using filters such as company name , job title, net worth, and more. Whether you’re identifying potential leads, researching professionals, or enriching your CRM, this API helps you quickly surface relevant profiles

Filters to Search People Data

Example

An example of a Search Request

curl --location 'https://api.factori.ai/v3/people/search' \
--header 'Content-Type: application/json' \
--header 'x-factori-apikey: <API-Key>' \
--data '{
    "filters": {
        "first_name": "sunil",
        "gender": "M"

    },
    "must_contain": ["homeowner"],
    "must_not_contain" : {
        "people_id": ["1"]
    },
    "page_no": 1,
    "page_size": 10
}'

2. Unlock

The Unlock People API allows you to access enriched profile information for individuals by using a combination of filters such as name, company, full address, or job title. It goes beyond the basic search results to provide verified contact details, social links, and other professional data that help you understand your target audience.

Filters to Unlock People Data

Option 1: Users must select at least one of the following:

Option 2 :
Users must select at least one of the following:

**AND ** Users must select at least one of the following:

An example of an Unlock Request

curl --location 'https://api.factori.ai/v3/people/unlock' \
--header 'Content-Type: application/json' \
--header 'x-factori-apikey: <API-Key>' \
--data '{
    "filters": {
        "first_name": "sunil",
        "company_name": "google"
    },
    "output_fields": [
        "social",
        "email",
    ],
    "page_no": 1,
    "page_size": 10
}'