Overview

The Query Builder is a free, no-code tool in the API Dashboard for constructing queries for the Person and Company Search APIs. It enables you to:

• View the results in the API Explorer Tool using the generated queries
• View real-time profile match counts without using API credits
• Generates code examples for executing and retrieving profile results 

Building a query

1. Choose the data type Person or Company you want to query
   1. If you are querying for Person data, you must also select which dataset you want to use
   2. We recommend selecting the resume dataset as it covers most use cases and contains the least duplication
      
2. Select the Add Rule button to add a rule to determine which profiles should be returned
3. A dropdown menu will appear with a list of available fields based on the selected data type
   1. Input parameters correspond to fields from the Person or Company datasets
      
4. Once the field is selected, choose the [Matching Logic] you want to use
   
5. Next, define the field value for the rule
   1. Many fields like as location_name, job_title, skills, industry, education.degrees, education.majors, and more will autocomplete as you type
      
6. For more complex queries, you can use the Add Group feature
   1. Select the logical operator (AND, OR) to determine how the rules within the group will be combined.
   2. For example, the following query will return profiles that have a work_email AND their location_region is California or New York
      
7. Finally click the Search button to generate:
   1. A count of profiles that match your query
   2. An option to explore the results with the Copy & Explore button
   3. Working code snippets that reflect your query.
      1. Code snippets are provided in PDL's JS SDK, Python SDK, Ruby SDK, and Go SDK, as well as pure Python, cURL, SQL, and ESQuery

Example Query

In this scenario, a recruiter wants to find the following:

• Senior Software Engineers with skills in Python
• UX Designers with skills in Figma
• The candidates must live in the United States or Canada
• They must have a personal email or mobile phone for contact

By utilizing the Query Builder tool, the recruiter can construct a query that meets these specific criteria. Check out the video below for a detailed walkthrough.

View the results using the API Explorer Tool

This video demonstrates how to view the results of a Query Builder search by clicking the Copy & Explore button.

Feedback

Is there a missing feature you'd like to see? We want to hear from you! 

Submit a feature request or vote on existing feature requests here: People Data Labs Roadmap