{"uid":"cap_5E96HMdMEJpAte3KRgPTb","slug":"oneshot-agent-person-finder-73adedf8","name":"OneShot Agent - Person Finder","description":"Tools, payments, and compute orchestration for autonomous AI agents.\n\n## Authentication\n\n- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).\n  First call returns `402 Payment Required` with a quote; sign and resend the request\n  with `payment-signature: <base64 x402 payment>` and `X-Quote-ID: <quote_id>`.\n- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).\n- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`\n  (issued by `POST /v1/soul/register`).\n- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the\n  `API-Version: 2026-01-30` header.\n\n## Async tools & polling\n\nMost tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll\n`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.\nA WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.\n\n## Pricing\n\nSee [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full\ntable. Per-call prices for this environment:\n\n| Tool | Cost |\n|---|---|\n| Web search | $0.001 |\n| Web read | $0.002 |\n| Research | $0.01 |\n| Person profile | $0.005 |\n| Person email status | $0.001 |\n| Person dossier | $0.10 |\n| Person social accounts | $0.50 |\n| Business search | $0.01 |\n| Commerce search | $0.002 |\n| LinkedIn history sync | $0.02 per bounded run |\n| LinkedIn reply | $0.02 per message |\n| LinkedIn message to a connection | $0.02 per message |\n| LinkedIn profile view | $0.01 per view |\n| LinkedIn post reaction | $0.01 per reaction |\n| Email send | quote-based; service fee from $0.005 per send |\n| SMS send | $0.0035 per segment per recipient |\n| Voice call | $0.35/minute + $5.00 number registration on the first call |\n| Browser task | quote-based; minimum $0.005 |\n| Website build | quote-based; from $1.00 |\n| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |\n\n## Error format\n\n`{ \"error\": \"<machine_code>\", \"message\": \"<human readable>\", \"details\": <optional> }`.\nValidation errors include a `details` field with the failing field paths.","url":"https://win.oneshotagent.com/v1/tools/find/person?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"Person search query"},"include_phone":{"type":"boolean","default":false,"description":"Phone lookup is off by default. include_phone=true adds the per-person add-on on the pricing page × requested limit (default 100) for up to that many people; no phone hit is guaranteed."}}},"responseSchema":{"type":"json","example":{"status":"processing","request_id":"uuid"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mqHqVw0eRPGLAEeCpno7j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for people by name or query, returning contact and profile data, with optional phone number lookup.","exampleAgentPrompt":"Find contact information for Jane Smith, the VP of Marketing at Acme Corp — and include her phone number if possible.","exampleUseCases":[{"title":"Sales prospecting contact lookup","prompt":"I need to find contact details for Michael Chen who works at Stripe as an engineering manager — include his phone number so I can reach out directly."},{"title":"Journalist or author research","prompt":"Look up Sarah Johnson, the tech journalist who writes for TechCrunch, and find whatever contact info is available for her."},{"title":"Recruiting candidate outreach","prompt":"Find information on David Park, a senior software engineer based in San Francisco — I want to reach out to him about a job opportunity, so include his phone number if you can."}],"resultDescription":"Returns a 202 Accepted with a request_id and status 'processing'. The agent must poll GET /v1/requests/{id} (with the same X-Agent-ID header) or subscribe via WebSocket to retrieve the final person search results, which include profile data and optionally phone numbers for matched individuals.","failureModes":["Person not found — query too vague or individual not in database","402 Payment Required on first call — must sign and resend with x402 payment signature and quote ID","Phone lookup returns no results — phone numbers not guaranteed even with include_phone=true","Polling times out — result may take longer than expected for large result sets","Invalid query format — missing or malformed query string returns 400 error","Rate limit or quota exceeded — too many requests in a short period"],"whenToPreferThis":"Use this endpoint when you need to find or enrich contact data for a specific person by name or description, especially when you need phone numbers in addition to basic profile info. Prefer it over company search when targeting an individual rather than an organization, and over email enrichment when you don't already have an email address to start from. Best for sales prospecting, recruiting outreach, journalism research, or any workflow where identifying and contacting a real person is the goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:44:29.064Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-person-finder-73adedf8"}