> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peopledatalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Builder Tool

> *A free resource for building Person and Company Search API queries*

## What Is It?

The [Query Builder ](https://dashboard.peopledatalabs.com/tools/query-builder)is a coding-free tool for constructing queries for the [Person](/docs/person-search-api) and [Company](/docs/company-search-api) Search APIs. It shows real-time profile match counts without using API credits and generates code examples for executing and retrieving profile results.

## Building a Query

1. Choose the **data type** ([Person](/docs/person-data-overview) or [Company](/docs/company-data-overview)) you want to query.
   1. If you are querying for Person data, you must also select which [dataset](/docs/datasets#list-of-slice-datasets) you want to use. We recommend selecting the resume dataset as it covers most use cases and contains the least duplication.

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/0Dx9WJ8G6RwVLrEr/images/docs/d47b38c-Screenshot_2023-06-10_at_1.54.44_PM.png?fit=max&auto=format&n=0Dx9WJ8G6RwVLrEr&q=85&s=ff10cffbdab60e387a514ad2d0331325" alt="" width="1971" height="1105" data-path="images/docs/d47b38c-Screenshot_2023-06-10_at_1.54.44_PM.png" />
</Frame>

2. Select the **"Add Rule"** button to add a rule to determine which profiles should be returned.

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/735dbcb-Screenshot_2023-06-10_at_1.55.05_PM.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=5f0ba1f6978119d88d466c127dc567a4" alt="" width="1986" height="918" data-path="images/docs/735dbcb-Screenshot_2023-06-10_at_1.55.05_PM.png" />
</Frame>

3. A dropdown menu will appear with a list of available **fields** based on the selected data type. Input parameters correspond to fields from the [Person](/docs/person-data-overview) or [Company](/docs/company-data-overview) datasets.

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/272bba6-Screenshot_2023-06-12_at_11.26.41_AM.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=9e3e9b4e533c026078b9337627cf4de1" alt="" width="587" height="441" data-path="images/docs/272bba6-Screenshot_2023-06-12_at_11.26.41_AM.png" />
</Frame>

4. Once the field is selected, choose the [Matching Logic](/docs/matching-logic-options) you want to use.

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/9103a88-Screenshot_2023-06-12_at_11.19.42_AM.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=d343352c59fa91edebcc633015d18e9c" alt="" width="576" height="452" data-path="images/docs/9103a88-Screenshot_2023-06-12_at_11.19.42_AM.png" />
</Frame>

5. Next, define the **field value(s)** for the rule. Fields with [canonical values](/docs/canonical-data) (such as `location_name`, `job_title`, `skills`, `industry`, `education.degrees`, `education.majors`, and more) will autocomplete as you type.

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/460203f-Screenshot_2023-06-10_at_1.56.09_PM.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=2b6a2096cadcfbb615f241ef82aa2bdd" alt="" width="1946" height="1325" data-path="images/docs/460203f-Screenshot_2023-06-10_at_1.56.09_PM.png" />
</Frame>

6. For more complex queries, you can use the **"Add Group"** feature. Select the logical operator (`AND`, `OR`) to determine how the rules within the group will be combined. For example, if you want to match profiles that satisfy at least one rule within the group, select `OR`.

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/120ee0e-Screenshot_2023-06-10_at_2.03.24_PM.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=9eda741ffea666f0fef68d7c1d786cfd" alt="" width="1342" height="1224" data-path="images/docs/120ee0e-Screenshot_2023-06-10_at_2.03.24_PM.png" />
</Frame>

7. Finally select **"Build Query"** to generate working code snippets that reflect your query. 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. Additionally, the tool will display the total number of profile matches for your query in real-time, without utilizing any API credits.

<Info>
  **Tips for Getting Started**

  To get results quickly, simply copy the cURL snippet and replace `"<INSERT YOUR API KEY>"` with [your API Key](/docs/quickstart#create-an-account). Paste the query into the the command line to retrieve the records.
</Info>

## Example Query

The following example demonstrates how to create nested queries using the "Add Group" feature.

In this scenario, a recruiter wants to find Full Stack Developers in San Francisco and UX Researchers in New York. By utilizing the Query Builder tool, the recruiter can construct a query that meets these specific criteria.

<Frame>
  <iframe src="https://www.loom.com/embed/57261e60c9364b56a059d81749365638" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen />
</Frame>

## Where to Find It

Anyone interested in trying out the Query Builder can sign up for a [free API key](https://dashboard.peopledatalabs.com/signup) and access the tool through the [API dashboard](https://dashboard.peopledatalabs.com/tools/query-builder).

## For More Information

For more information, check out our detailed walkthroughs of the Query Builder:

* [https://blog.peopledatalabs.com/post/how-to-find-candidates-using-a-job-description](https://blog.peopledatalabs.com/post/how-to-find-candidates-using-a-job-description)


## Related topics

- [November 2025 Release Notes](/changelog/november-2025-release-notes-v321.md)
- [October 2025 Release Notes](/changelog/october-2025-release-notes-v320.md)
- [September 2025 Release Notes](/changelog/september-2025-release-notes-v312.md)
- [August 2025 Release Notes](/changelog/august-2025-release-notes-v311.md)
- [October 2021 Release Notes](/changelog/october-2021-release-notes-v16.md)