# Vaaya OneFind - People Search

> Vaaya OneFind - People Search is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-19).

Find people matching a plain-English description or look up a specific person by name and company, returning structured rows with LinkedIn, title, location, and sources.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/vaaya/onefind?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-onefind-people-search-106f2531
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xhEg99tyC3RFLPUWPwXjW

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 vaaya-onefind-people-search-106f2531 -d '<json body>'
```

Example prompt: Find me up to 20 heads of product at Series B SaaS startups in the US — I need their names, titles, companies, and LinkedIn profiles.

## When to prefer this

Choose this endpoint when you need to discover or look up professional people profiles using natural language descriptions (e.g. job roles, company stages, geographies) or a specific name+company pair. It is ideal for sales prospecting, recruiting research, or identifying key contacts at target companies. It returns structured, sourced rows with LinkedIn URLs suitable for downstream outreach or enrichment workflows. Prefer this over generic web search when you want clean structured people data rather than raw HTML.

## Known failure modes

- Query too vague — returns irrelevant or empty results
- Specific person not found — returns empty rows or closest match
- Limit out of range (must be 1–25) — validation error
- Query string too short (under 2 characters) or too long (over 500) — validation error
- Name+company lookup ambiguous — may return wrong person if multiple matches exist
- Rate limiting or payment failure due to insufficient USDC balance

## How this service works

Vaaya OneFind: find people from a plain-English query, as rows. Pass `query`, either a description ("series A fintech founders in India", "heads of talent at Series B startups") for a table of people, or a name + company ("Jerry Liu LlamaIndex") for that one person (the response says which: `person: true/false`), plus optional `limit` (1–25, default 15). Returns `rows`, each with name, title, company, location, linkedin and per-field `sources`. Contact fields (email, phone) are null and `enrich…

## Output

Returns a list of rows (up to 25), each containing: person name, job title, company, location, LinkedIn URL, and per-field source citations. Also indicates whether the response represents a single person lookup (person: true) or a list result (person: false). Contact fields like email and phone are null unless enriched separately.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 15,
       "maximum": 25,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "maxLength": 500,
       "minLength": 2
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaaya-onefind-people-search-106f2531/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)