People + Company Filters - Pubrio Documentation

POST /people/search accepts every company filter that POST /companies/search accepts. You no longer need to pre-fetch companies, collect their IDs, and feed them into a second people query — one request does both layers.

Two parameter families, one body

A /people/search request body is split conceptually into two filter families. They live at the same level in the JSON, and you mix them freely.

People-level
Company-level

Filter on attributes of the person:

Parameter	Description
`people_titles`	Job titles (free text or slug)
`management_levels`	`founder`, `c_suite`, `vp`, `director`, `manager`, …
`departments`	`master_engineering_technical`, `master_sales`, …
`department_functions`	Sub-department / function slugs
`people_locations`	Country codes for the person’s location
`people_groups`	Saved group IDs
`peoples`	Specific `people_search_id` values
`linkedin_urls`	Person LinkedIn URLs
`social_media`	Per-network social-media handles

Filter on attributes of the company the person works at — same names as /companies/search, with a small set of company_-prefixed location keys:

Parameter	Description
`technologies`	Technology slug IDs the company uses
`categories`	Category slug IDs
`verticals`	Vertical slug IDs
`vertical_categories`	Vertical category slug IDs
`vertical_sub_categories`	Vertical sub-category slug IDs
`keywords`	Free-text keywords matched against the company description
`founded_dates`	Founded-year range, e.g. `[2015, 2023]`
`employees`	Employee buckets, e.g. `[[100, 500], [501, 1000]]`
`revenues`	Revenue buckets in USD
`company_locations`	Country codes for the company HQ
`company_exclude_locations`	Country codes to exclude
`company_places`	City / region names to include
`company_exclude_places`	City / region names to exclude
`companies`	Specific `domain_search_id` values
`domains`	Specific company domains
`company_linkedin_urls`	Company LinkedIn URLs

At the top level of /people/search, the company location and place filters carry a company_ prefix; the bare locations / places keys are not accepted there and are reported in metadata.ignored_fields. Everything else uses the bare company name (technologies, not company_technologies). Inside company_filters either spelling works.

Build a query in four steps

Decide the people predicate

Who, exactly? Title, seniority, department, country. Keep this layer at the top level of the body — the company predicate usually does the precision work.

Decide the company predicate

Which companies do they need to work at? Industry, size, founded year, HQ country, technology stack. Group these under a company_filters: {...} object so it’s obvious which layer each key belongs to.

Pick AND/OR per filter via filter_conditions

For any multi-value filter that needs precision (e.g., “uses all of these techs”), add an entry to filter_conditions inside company_filters. Defaults are OR.

Send the request

POST /people/search. Both styles are accepted, but company_filters: {...} reads cleaner and matches the Monitors payload shape.

Complete example

The query: VPs of Engineering or CTOs at US-based mid-market companies founded between 2015 and 2023, employing 100-5,000 people, that use both Kubernetes and Docker, but excluding companies HQ’d in San Francisco.

curl -X POST https://api.pubrio.com/people/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "people_titles": ["VP of Engineering", "CTO"],

    "company_filters": {
      "company_locations": ["US"],
      "company_exclude_places": ["San Francisco"],
      "founded_dates": [2010, 2024],
      "employees": [[100, 500], [501, 1000], [1001, 5000]],
      "technologies": ["Kubernetes", "Docker"],
      "is_enable_similarity_search": true
    },

    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/people/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "people_titles": ["VP of Engineering", "CTO"],

        "company_filters": {
            "company_locations": ["US"],
            "company_exclude_places": ["San Francisco"],
            "founded_dates": [2010, 2024],
            "employees": [[100, 500], [501, 1000], [1001, 5000]],
            "technologies": ["Kubernetes", "Docker"],
            "is_enable_similarity_search": True,
        },

        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/people/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    people_titles: ["VP of Engineering", "CTO"],

    company_filters: {
      company_locations: ["US"],
      company_exclude_places: ["San Francisco"],
      founded_dates: [2010, 2024],
      employees: [[100, 500], [501, 1000], [1001, 5000]],
      technologies: ["Kubernetes", "Docker"],
      is_enable_similarity_search: true,
    },

    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Key remap reference

On /people/search the company location and place keys carry a company_ prefix. They correspond to the Company Search names like this:

You send on `/people/search`	Company Search name
`company_locations`	`locations`
`company_exclude_locations`	`exclude_locations`
`company_places`	`places`
`company_exclude_places`	`exclude_places`
`technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`	same name

filter_conditions keys never take the prefix — use technologies, verticals, keywords and the other names listed under Supported keys. Location and place filters always match any listed value.

People without a company

Adding any company-level filter limits the result to people with a recognised company on file. People without one are excluded, even when they match every people-level filter.

If your search drops to zero rows the moment you add company_locations or technologies, check whether the people you expect have a company linked.

Every returned person includes a populated company object whenever any company filter was applied.

Common patterns

Account-Based Marketing (ABM)

Target a fixed list of companies (companies or domains), then layer on people-level filters to find the right buyers inside each one.

{
  "people_titles": ["VP Marketing", "CMO"],
  "management_levels": ["vp", "c_suite"],
  "company_filters": {
    "companies": ["67c4696b-…", "f1e2d3c4-…", "0a9b8c7d-…"]
  }
}

Ideal Customer Profile (ICP) discovery

Describe the company shape, not specific accounts. Use ranges and verticals — the engine returns the people that fit.

{
  "people_titles": ["Head of Engineering"],
  "company_filters": {
    "verticals": [69086912],
    "company_locations": ["US", "CA"],
    "founded_dates": [2015, 2023],
    "employees": [[51, 200], [201, 500]]
  }
}

Technology-driven prospecting

Find buyers at companies running a specific stack. AND on technologies is the typical override.

{
  "people_titles": ["RevOps", "Sales Operations"],
  "departments": ["master_sales"],
  "company_filters": {
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ]
  }
}

Competitor displacement

Find decision-makers at companies that use a competitor’s product (one tech) but not yours (excluded via categories or a separate filter pass).

{
  "people_titles": ["VP Sales"],
  "management_levels": ["vp"],
  "company_filters": {
    "technologies": [287]
  }
}

Then re-run with technologies: [114] (your product’s tag ID) and diff client-side.

Next steps

filter_conditions

Full reference — every key, every default, copyable AND/OR recipes.

Filters Overview

The mental model behind the unified filter engine.

People Search reference

Full request/response schema for /people/search.

Company Search reference

Full request/response schema for /companies/search.

​Two parameter families, one body

​Build a query in four steps

​Complete example

​Key remap reference

​People without a company

​Common patterns

​Next steps

filter_conditions

Filters Overview

People Search reference

Company Search reference

Two parameter families, one body

Build a query in four steps

Complete example

Key remap reference

People without a company

Common patterns

Next steps