{"uid":"cap_TPG2iWPuKQIum5qsVTGhf","slug":"orthogonal-person-search-by-company-51c62ecc","name":"Orthogonal Person Search by Company","description":"Start async person search by company name, role, geography, and person name. Returns requestId for polling. Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later offset or cursor pages of the same search, pass parentRequestId with unchanged search parameters. Valid continuation pages still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable search.","url":"https://x402.orthogonal.com/nyne/person/search","method":"POST","headers":{},"bodySchema":{"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","properties":{"type":{"type":"string","description":"Search tier: light (fastest), medium, premium (best quality). Default: premium"},"limit":{"type":"integer","description":"Max results per request (default: 10, max: 100)"},"query":{"type":"string","description":"Natural language search query (max 1000 chars)"},"cursor":{"type":"string","description":"Pagination token from a previous response. For continuation billing, keep search filters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response."},"offset":{"type":"integer","description":"Starting position in results (default: 0, max: 999). For later pages of the same logical search, keep search filters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response."},"insights":{"type":"boolean","description":"Include AI-generated relevance insights (default: false, not available for light)"},"force_new":{"type":"boolean","description":"Force fresh search even if cached (default: false)"},"request_id":{"type":"string","description":"Nyne request ID to continue fetching from the same search. For Orthogonal continuation billing, also pass top-level parentRequestId from the first /v1/run response."},"show_emails":{"type":"boolean","description":"Include email addresses in results (default: false)"},"callback_url":{"type":"string","description":"URL to receive results via webhook"},"custom_filters":{"type":"object","description":"Structured filters (locations, industries, titles, etc.)"},"high_freshness":{"type":"boolean","description":"Prioritize recently updated profiles (default: false, not available for light)"},"require_emails":{"type":"boolean","description":"Only return profiles with emails (default: false)"},"profile_scoring":{"type":"boolean","description":"Include AI relevance scoring (default: false)"},"show_phone_numbers":{"type":"boolean","description":"Include phone numbers in results (default: false)"},"require_phone_numbers":{"type":"boolean","description":"Only return profiles with phones (default: false)"},"require_phones_or_emails":{"type":"boolean","description":"Only return profiles with phone OR email (default: false)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.36285","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.36285/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.36285","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.36285","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GAAmWeWTkgeCFZVSUEVHL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.36285","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Starts an asynchronous person search filtered by company name, role, geography, and person name, returning a requestId for polling results.","exampleAgentPrompt":"Find me people at Stripe who work as engineers in San Francisco — search by company 'Stripe', role 'engineer', and location 'San Francisco'.","exampleUseCases":[{"title":"B2B Sales Lead Discovery","prompt":"Search for VP of Sales contacts at Salesforce based in New York — I need a list of people matching that role and company to prospect into."},{"title":"Recruiting Candidate Search","prompt":"Find me software engineers currently at Google in London — I'm hiring and want a list of potential candidates at that company in that city."},{"title":"Account Research by Named Person","prompt":"Look up anyone named 'Sarah Chen' who works at OpenAI, especially if they're in a product or research role — I want to verify if she's there and get her details."}],"resultDescription":"Returns a requestId that the caller can use to poll for the completed search results, along with a billing requestId for managing paginated continuation requests at zero additional cost when search parameters remain unchanged.","failureModes":["Invalid or missing required search parameters returns a validation error","If parentRequestId is provided but search parameters differ from the original request, a new billable search is started","Polling with an expired or invalid requestId may return a not-found error","Overly broad searches with no filters may result in very large result sets or timeouts","Network errors or service unavailability return standard HTTP error codes"],"whenToPreferThis":"Choose this endpoint when you need to asynchronously search for people across one or more filters (company, role, geography, name) and can tolerate a polling-based retrieval pattern. It is especially well-suited for paginated bulk searches where you want to avoid re-billing on continuation pages by passing a parentRequestId. Prefer it over synchronous person lookup endpoints when result sets may be large or latency tolerance is higher.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:45.834Z","isFirstParty":false}