Person Data API V1.2

We are pleased to introduce Person Data API v1.2, featuring significant updates designed to enhance your data search capabilities and user experience.
This release includes the ability to search by full address, industry-specific search using SIC and NAICS codes, pagination, new employee attribute filters, and the ability to exclude specific People from search results.

1. Full Address Search Capability

Feature Overview: Users can now search for Persons based on their complete address using the full_address attribute. This update streamlines locating individuals by allowing you to input a full address in one field.

Key Points:
USPS Standardization: The full_address must adhere to USPS standards. Address suffixes like Lane, Drive, and Boulevard should be abbreviated to Ln, Dr, and Blvd, respectively.
Field Precedence: If the full_address field includes the full address along with city and state, and the user also provides city and state in individual fields, the API will prioritize the values in the particular fields over the full_address field.

Visual Example:

If both the full_address and individual city and state fields are populated, the API will prioritize the city and state fields.

2. Industry-Based Search Using SIC and NAICS Codes

Feature Overview: This feature allows users to search for Persons working within specific industries using company_sic and company_naics codes. These codes are standardized industry classifications, making identifying individuals within particular sectors easier.

How to Use:
SIC Code Search: Add company_sic to your search filters to retrieve data related to a specific industry.
NAICS Code Search: Use company_naics to search by industry based on the NAICS classification system.

Visual Example:

Implementation:

{  
    "persons_attributes": {  
        "company_sic_code": "7372"  
    }  
}

This feature helps target searches to retrieve relevant data based on industry-specific criteria.

3. Pagination for Enhanced Data Management

Feature Overview: Pagination has been introduced to allow users to manage large datasets more effectively and prevent unnecessary API credit consumption. You can now retrieve data in manageable chunks by specifying the page number.

How It Works:
Pagination Control: Use the page_no attribute to navigate through pages of data.
Credit Efficiency: Pagination reduces the likelihood of exhausting API credits by retrieving smaller, more manageable data sets.

Visual Example:
Imagine your search returns 1,000 results. Instead of pulling all 1,000 at once, you can now paginate:
Page 1: Results 1-100
Page 2: Results 101-200

Implementation:

{  
    "persons_attributes": {  
        "gender": "f",  
        "state": "pa"  
    },  
    "must_not_contain": {  
        "person_id": ["a14704be8af3bd14c1175330a22aecbf6b0cca01"]  
    },  
    "page_no": 2  
}

4. Employee Attribute Filtering

Feature Overview: Users can now refine their searches by filtering based on specific employee attributes, such as employee_title, employee_department, employee_level, and employee_job_function. This allows for more precise data retrieval, especially when targeting specific roles within a company.

Key Points:
Employee Title: Search by specific job titles.
Employee Department: Narrow down results by department.
Employee Level: Filter by employee seniority level.
Employee Job Function: Find employees based on their job function.

Visual Example:

Implementation:

{  
    "persons_attributes": {  
        "employee_title": "Software Engineer",  
        "employee_department": "Engineering"  
    }  
}

This feature is particularly useful for HR professionals or recruiters looking for candidates within specific roles or departments.

5. Exclude Specific Persons from Search Results

Feature Overview: The must_not_contain attribute has been added to allow users to exclude specific Persons from their search results, helping to refine data queries further.

How It Works:
Exclusion by Person ID: Input specific person_ids that you wish to exclude from your search results.
Multiple Exclusions: The attribute accepts an array of person_ids, allowing for multiple exclusions in a single query.

Visual Example:

Implementation:
This feature is ideal for filtering out unwanted data, ensuring your results are as relevant as possible.

{  
    "persons_attributes": {  
        "gender": "f",  
        "state": "pa"  
    },  
    "must_not_contain": {  
        "person_id": ["a14704be8af3bd14c1175330a22aecbf6b0cca01"]  
    },  
    "page_no": 2  
}

6. Improved Street-Level Search

Feature Overview:
The street attribute has been added to enable users to search for Persons based on specific street names, enhancing the granularity of your search queries.

How It Works:

• Street-Specific Search: Users can now input a specific street name to find all associated Persons.
• Flexible Input: The attribute accepts street names as input, allowing for more precise data retrieval.

Visual Example:

Implementation:

{
    "persons_attributes": {
        "street": "central park"
    }
}

This feature is perfect for narrowing down search results based on specific locations, providing more targeted and relevant data.

Conclusion

Person Data API v1.2 introduces powerful new features and enhancements to improve your data search and retrieval processes.

If you have any questions or need support, please contact our team [email protected]