# Pubrio People Search

> Pubrio People Search is a paid API for AI agents from agents.pubrio.com, paid per call via MPP, ~$0.03/call (observed), status down (last checked 2026-10-12, last successful call 2026-10-09).

Search the Pubrio database of 560M+ contacts for people matching structured or natural-language criteria such as job title, seniority, company, location, and industry.

## Facts

- Endpoint: POST https://agents.pubrio.com/people/search?utm_source=zero.xyz
- Price: ~$0.03/call (observed)
- Payment: MPP
- Status: down
- Last checked: 2026-10-12
- Last successful call: 2026-10-09
- Success rate: 100% of calls made through Zero
- Rating: 4.0 / 5 from 1 review
- Activations on Zero: 13
- Provider: agents.pubrio.com
- Website: https://agents.pubrio.com
- Canonical page: https://www.zero.xyz/c/agents-pubrio-com-pubrio-people-search-cadae2b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tnxLT_HesC8mlY23QwLxh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-pubrio-com-pubrio-people-search-cadae2b0 -d '<json body>'
```

Example prompt: Search Pubrio for VP-level or above marketing decision makers at fintech companies in Singapore — show me the first 25 results.

## When to prefer this

Use this endpoint when you need to search across Pubrio's 560M+ contact database using flexible criteria — either structured filters (title, seniority, company domain, location, revenue) or plain-language queries. Prefer this over look-up-by-ID endpoints when you don't have a specific person's Pubrio ID or LinkedIn URL. Best suited for prospecting, lead generation, and identifying decision-makers at target companies, especially with strong coverage of APAC and emerging markets that Western datasets underserve.

## Known failure modes

- HTTP 416 returned when requested page exceeds subscription's max_search_page limit
- HTTP 416 with code 41613 when per_page exceeds subscription's max_search_per_page
- Empty result set when filters are too restrictive or no matching contacts exist
- Malformed domain URLs auto-converted but may not resolve to correct company if domain is ambiguous
- Credits deducted even on zero-result responses
- Natural language query may be misinterpreted if conflicting explicit filters are not provided

## How this service works

Search the Pubrio database for people matching specified criteria such as job title, location, company, and seniority.

## Output

Returns a paginated list of person records matching the search criteria, including names, job titles, seniority levels, departments, company affiliations, LinkedIn URLs, and location data. Also includes metadata with echoed filters, credit usage details, and any ignored fields from the request body.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "example": 1,
   "description": "Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**."
  },
  "query": {
   "type": "string",
   "example": "decision makers in marketing",
   "description": "Natural-language search. When provided, Pubrio interprets it into the person and company filters below (job role, seniority, department, location, industry, company size, and more). Any explicit filters you also pass take precedence over the interpreted ones. Leave empty to search purely by the structured filters."
  },
  "domains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "pubrio.com"
   ],
   "description": "List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing."
  },
  "filters": {
   "type": "object"
  },
  "peoples": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uuid"
   },
   "description": "A list of unique identifiers (people_search_id) used for people search operations."
  },
  "keywords": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "ecommerce",
    "ai",
    "fintech"
   ],
   "description": "A list of keywords to filter companies by relevance, specialties, or descriptions."
  },
  "per_page": {
   "type": "integer",
   "default": 25,
   "example": 25,
   "maximum": 25,
   "description": "Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set."
  },
  "revenues": {
   "type": "array",
   "items": {
    "type": "integer"
   },
   "example": [
    0,
    100000
   ],
   "description": "Minimum and maximum range of company revenue."
  },
  "companies": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uuid"
   },
   "description": "A list of unique identifiers (domain_search_id) used for company and people search operations."
  },
  "employees": {
   "type": "ar
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "nullable": true,
   "description": "Response info depends on specific endpoint."
  },
  "metadata": {
   "type": "object",
   "description": "Request context: echoed `filters` and `parameters`, an optional `profile` credit block, and `ignored_fields` (body keys the endpoint dropped)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-pubrio-com-pubrio-people-search-cadae2b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.pubrio.com](https://www.zero.xyz/host/agents.pubrio.com/llms.txt)