# OneShot Person Profile Lookup

> OneShot Person Profile Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Looks up a person's professional profile (name, company, headline, and optionally phone) given a LinkedIn URL.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/person-profile?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-person-profile-lookup-d6162528
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qex-XWgXyXI8xjqdyN3ZW

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 oneshot-person-profile-lookup-d6162528 -d '<json body>'
```

Example prompt: Can you look up the professional profile for the person at linkedin.com/in/johndoe — I need their name, current company, and job headline? Also grab their phone number if you can.

## When to prefer this

Use this endpoint when you have a LinkedIn URL and need structured professional profile data (name, company, headline, optional phone) for a specific individual. Prefer this over general web search when you need clean, structured enrichment rather than raw text. Best suited for sales prospecting, recruiting workflows, or any agent pipeline that needs to enrich a known LinkedIn identity with professional details at low cost ($0.001/call).

## Known failure modes

- LinkedIn URL is invalid or not found — returns an error or empty result
- Phone number not available despite include_phone=true — field omitted or null
- 402 Payment Required on first call — must complete x402 payment flow before result is returned
- Rate limiting or quota exceeded — retry after delay
- Profile is private or restricted — may return partial data or error

## How this service works

Tools, payments, and compute orchestration for autonomous AI agents.

## Authentication

- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).
  First call returns `402 Payment Required` with a quote; sign and resend the request
  with `payment-signature: <base64 x402 payment>` and `X-Quote-ID: <quote_id>`.
- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).
- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`
  (issued by `POST /v1/soul/register`).
- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the
  `API-Version: 2026-01-30` header.

## Async tools & polling

Most tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll
`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.
A WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.

## Pricing

See [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full
table. Per-call prices for this environment:

| Tool | Cost |
|---|---|
| Web search | $0.001 |
| Web read | $0.002 |
| Research | $0.01 |
| Person profile | $0.005 |
| Person email status | $0.001 |
| Person dossier | $0.10 |
| Person social accounts | $0.50 |
| Business search | $0.01 |
| Commerce search | $0.002 |
| LinkedIn history sync | $0.02 per bounded run |
| LinkedIn reply | $0.02 per message |
| LinkedIn message to a connection | $0.02 per message |
| LinkedIn profile view | $0.01 per view |
| LinkedIn post reaction | $0.01 per reaction |
| Email send | quote-based; service fee from $0.005 per send |
| SMS send | $0.0035 per segment per recipient |
| Voice call | $0.35/minute + $5.00 number registration on the first call |
| Browser task | quote-based; minimum $0.005 |
| Website build | quote-based; from $1.00 |
| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |

## Error format

`{ "error": "<machine_code>", "message": "<human readable>", "details": <optional> }`.
Validation errors include a `details` field with the failing field paths.

## Output

Returns a JSON object with the person's full name, current company, and professional headline. If include_phone is true, a phone number may also be returned (not guaranteed). The endpoint responds asynchronously with a 202 and a request_id; poll GET /v1/requests/{id} for the final result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Full name"
  },
  "email": {
   "type": "string",
   "format": "email",
   "description": "Email address"
  },
  "phone": {
   "type": "string",
   "description": "Phone number"
  },
  "company": {
   "type": "string",
   "description": "Employer name or domain, e.g. \"Coinbase\" or \"coinbase.com\""
  },
  "profile_url": {
   "type": "string",
   "format": "uri",
   "description": "Profile URL on LinkedIn, X or GitHub"
  },
  "company_name": {
   "type": "string",
   "description": "Employer name (older name; company takes a name or a domain)"
  },
  "linkedin_url": {
   "type": "string",
   "format": "uri",
   "description": "Same as profile_url (older name)"
  },
  "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 for up to one person; no phone hit is guaranteed."
  },
  "company_domain": {
   "type": "string",
   "description": "Employer domain (older name; company takes a name or a domain)"
  },
  "social_media_url": {
   "type": "string",
   "format": "uri",
   "description": "Same as profile_url (older name)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "John Doe",
  "company": "Acme",
  "headline": "Software Engineer"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-person-profile-lookup-d6162528/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)
