# Search for Similar People

> Search for Similar People is a paid API for AI agents from agents.pubrio.com, paid per call via MPP or x402, $0.03/call, status unknown (last checked 2026-10-12).

Find people similar to a reference person, LinkedIn URL, or job title using Pubrio's 800M+ contact graph, with each result scored by similarity.

## Facts

- Endpoint: POST https://agents.pubrio.com/people/search/similar?utm_source=zero.xyz
- Price: $0.03/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: agents.pubrio.com
- Website: https://agents.pubrio.com
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-pubrio-com-search-for-similar-people-07f8283d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kNIU80padCb5Lf5ep9ik7

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-search-for-similar-people-07f8283d -d '<json body>'
```

Example prompt: Find me people on Pubrio similar to this LinkedIn profile — https://www.linkedin.com/in/jane-doe-cto — filtered to companies in the fintech space with 50–200 employees, and show me the top 25 results with their similarity scores.

## When to prefer this

Use this endpoint when you need to discover new contacts who resemble a known reference person — ideal for lookalike prospecting, talent sourcing, or expanding a persona-based list. Prefer this over general people search when you have a seed identity (LinkedIn URL, Pubrio ID, or job title) and want similarity-ranked results rather than filter-only results. Choose this over company-level endpoints when the unit of interest is an individual professional rather than an organization.

## Known failure modes

- HTTP 416 if page exceeds subscription max_search_page or per_page exceeds max_search_per_page (code 41613)
- No reference supplied — request rejected if none of people_search_id, linkedin_url, linkedin_urls, peoples, or people_titles is provided
- Invalid UUID format in peoples array returns validation error
- No results returned if filters are too restrictive in combination with the reference
- Credit exhaustion results in a credit-related error response

## How this service works

Pubrio detects when companies enter new markets and returns the company and people data behind each move. Expansion signals (local hiring, new offices and entities, localized ads, news, cloud hosting) are typed, dated and tied to evidence across 200+ markets, with strong coverage of Asia-Pacific and other markets that Western-built datasets miss. The graph covers 800M+ companies and 560M+ contacts from 50+ local data sources, refreshed daily. Search companies, people, job postings, news, ads and cloud footprints with filters or a plain-language query; look up records by domain, LinkedIn URL or Pubrio id; find lookalike companies and people; read hiring, news, advertising and cloud insights for one company; and reveal verified work emails, personal emails and phone numbers. Each call costs the number of credits listed on its endpoint. This server is a pay-per-use, transparent proxy in front of Pubrio's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.

## Output

Returns a paginated list of person records each containing profile details (name, title, company, LinkedIn URL, contact info) and a similarity_score between 0 and 1 indicating closeness to the reference. Also includes metadata with echoed filters, pagination parameters, and credit usage (credit, topup_credit, total_credit_cost).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "example": 1,
   "description": "Page number, starting at 1."
  },
  "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."
  },
  "peoples": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uuid"
   },
   "description": "A list of unique identifiers (people_search_id) used for people search operations."
  },
  "per_page": {
   "type": "integer",
   "default": 25,
   "example": 25,
   "maximum": 25,
   "description": "Records per page, 1 to 25. Defaults to 25."
  },
  "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": "array",
   "items": {
    "type": "array",
    "items": {
     "type": "string"
    }
   },
   "example": [
    [
     1,
     10
    ],
    [
     11,
     20
    ],
    [
     10001
    ]
   ],
   "description": "The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results."
  },
  "departments": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "master_human_resources"
   ],
   "description": "The department field can search for people in specific areas of expertise."
  },
  "people_name": {
   "type": "string",
   "example": "king",
   "description": "Filter search results to include a specific people name."
  },
  "search_term": {
   "type": "string",
   "example": "pubrio",
   "description": "A string of words over which we want to filter the results."
  },
  "linkedin_url": {
   "type": "string",
   "description": "A single LinkedIn profile URL to use as the reference."
  },
  "linkedin_urls": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "example": [
    "http://www.linkedin.com/in/king-lai-605382b7"
   ],
   "description": "The fully formed URL of the LinkedIn user profile. URL begin with http and contain linkedin.com/in/ or linkedin.com/pub/"
  },
  "people_titles": {
   "type": "array",
   "items
… (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`, plus a `profile` block with `credit`, `topup_credit` and `total_credit_cost` when credit accounting is requested."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-pubrio-com-search-for-similar-people-07f8283d/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)