{"uid":"cap_Qex-XWgXyXI8xjqdyN3ZW","slug":"oneshot-person-profile-lookup-d6162528","name":"OneShot Person Profile Lookup","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/lookup/person-profile?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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)"}}},"responseSchema":{"type":"json","example":{"name":"John Doe","company":"Acme","headline":"Software Engineer"}},"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_85Xb-4e68bmYfux9J0tEH","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":"Looks up a person's professional profile (name, company, headline, and optionally phone) given a LinkedIn URL.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Sales lead enrichment from LinkedIn","prompt":"I have a LinkedIn URL for a prospect — linkedin.com/in/jane-smith-marketer — can you pull their current company, title, and headline so I can personalize my outreach?"},{"title":"Recruiting candidate research","prompt":"We're interviewing someone whose LinkedIn is linkedin.com/in/alex-chen-dev — can you fetch their professional profile including their current role and employer before the call?"},{"title":"Contact lookup with phone for outreach","prompt":"Look up linkedin.com/in/michael-torres-sales and include their phone number if available — I need to reach them directly."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:37:33.633Z","isFirstParty":false,"canonicalSlug":"oneshot-person-profile-lookup-d6162528"}