{"uid":"cap_qQf5byi_TD0lgb5Mmi7aC","slug":"nyne-person-search-via-paysponge-x402-d612c508","name":"Nyne Person Search (via PaySponge x402)","description":"Search for people with a natural-language query, or continue a previous search by resubmitting a request_id or cursor. Nyne's upstream docs also describe GET /person/search polling, but the current PaySponge purchase service does not register that route and returns 404 there as of May 4, 2026. Use POST /person/search with request_id or cursor for continuation on the live x402 wrapper.","url":"https://api.paysponge.com/x402/purchase/svc_d5ymfernpzeh58gb8/person/search","method":"POST","headers":{},"bodySchema":{"type":"object","anyOf":[{"required":["query"]},{"required":["cursor"]},{"required":["request_id"]}],"properties":{"type":{"enum":["light","premium"],"type":"string","default":"premium","description":"Search quality tier."},"limit":{"type":"integer","default":10,"minimum":1,"description":"Maximum number of results to return."},"query":{"type":"string","maxLength":1000,"description":"Natural-language description of the people to find."},"cursor":{"type":"string","description":"Opaque next_cursor value from an earlier response."},"offset":{"type":"integer","minimum":0,"description":"Zero-based starting position. Offset plus limit cannot exceed 1000."},"exclude":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"LinkedIn usernames to exclude."},"insights":{"type":"boolean","default":false,"description":"Include AI-generated insights about each result. Ignored for light searches."},"force_new":{"type":"boolean","default":false,"description":"Force a new search instead of reusing cached results."},"request_id":{"type":"string","description":"Earlier Nyne request id to continue or replay cached search results."},"show_emails":{"type":"boolean","default":false},"callback_url":{"type":"string","format":"uri"},"custom_filters":{"type":"object","description":"Structured filters for precise targeting. The upstream docs reference a separate custom filter section; unlisted fields are preserved here as a free-form object.","additionalProperties":true},"high_freshness":{"type":"boolean","default":false,"description":"Prioritize recently updated profiles. Ignored for light searches."},"require_emails":{"type":"boolean","default":false},"profile_scoring":{"type":"boolean","default":false,"description":"Include an AI relevance score per result."},"show_phone_numbers":{"type":"boolean","default":false},"require_phone_numbers":{"type":"boolean","default":false},"require_phones_or_emails":{"type":"boolean","default":false}},"description":"Nyne person search request. Query is required unless request_id or cursor is provided to continue an earlier search.","additionalProperties":false},"responseSchema":{"type":"object","required":["success","data","timestamp"],"properties":{"data":{"type":"object","required":["request_id","status"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"status":{"enum":["pending","queued","processing","finding","fetching","analyzing","enriching","gathering","aggregating","searching","discovering","running","started","in_progress","completed","complete","success","succeeded","failed","error","not_found","cancelled","canceled","timeout","timed_out"],"type":"string"},"results":{"type":"array","items":{"allOf":[{"type":"object","properties":{"bio":{"type":"string"},"gender":{"type":"string"},"headline":{"type":"string"},"lastname":{"type":"string"},"location":{"type":"string"},"newsfeed":{"type":"array","items":{"$ref":"#/components/schemas/NewsfeedItem"}},"altemails":{"type":"array","items":{"type":"string","format":"email"}},"firstname":{"type":"string"},"fullphone":{"type":"array","items":{"$ref":"#/components/schemas/PhoneEntry"}},"displayname":{"type":"string"},"probability":{"enum":["high","medium","low","unknown"],"type":"string"},"schools_info":{"type":"array","items":{"$ref":"#/components/schemas/Education"}},"organizations":{"type":"array","items":{"$ref":"#/components/schemas/Organization"}},"social_profiles":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/SocialProfile"}},"schools_attended":{"type":"array","items":{"type":"string"}},"is_decision_maker":{"type":"boolean"},"best_business_email":{"type":"string","format":"email"},"best_personal_email":{"type":"string","format":"email"},"total_experience_years":{"type":"number"}},"additionalProperties":true},{"type":"object","properties":{"score":{"type":"number","maximum":1,"minimum":0},"insights":{"$ref":"#/components/schemas/SearchInsights"}},"additionalProperties":true}]}},"has_more":{"type":"boolean"},"completed":{"type":"boolean"},"from_cache":{"type":"boolean"},"request_id":{"type":"string"},"next_cursor":{"type":"string"},"total_stored":{"type":"integer"},"total_estimate":{"type":"integer"},"credits_charged":{"type":"number"}},"additionalProperties":true},"success":{"type":"boolean"},"timestamp":{"type":"string"}},"additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402","data"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YW4MV7TMPU51jeNDuPwb9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for people using a natural-language query, with support for pagination, contact discovery, AI insights, and profile scoring — gated by on-chain USDC micropayment.","exampleAgentPrompt":"Find me up to 20 premium-quality profiles of senior software engineers at Series B fintech startups in New York who are likely decision-makers — include their best business emails and AI insights about each person.","exampleUseCases":[{"title":"Find biotech recruiters with contact info","prompt":"Search for talent acquisition managers and technical recruiters at biotech or pharmaceutical companies in the Boston area — I want their work emails and phone numbers if available, and give me AI insights on the top 10 results."},{"title":"Discover climate tech startup founders","prompt":"Find me up to 15 high-quality profiles of founders or co-founders running early-stage climate tech or clean energy startups — ideally people who've recently raised seed or Series A funding. Include their emails and any AI insights about their background."},{"title":"Paginate previous sales prospect search","prompt":"I ran a search earlier and got the first page of results — here's the request_id from that search. Pull me the next page of profiles using the cursor so I don't have to pay for a full new search."}],"resultDescription":"Returns a JSON object with a request_id, search status, an array of person profiles (each containing name, location, headline, bio, social profiles, emails, phone numbers, organization history, education, AI insights, and relevance score), pagination fields (has_more, next_cursor, offset, limit), and cache metadata. Results may be pending on first call if the search is still processing.","failureModes":["Query missing with no cursor or request_id provided — schema validation error","offset + limit exceeds 1000 — rejected with validation error","Invalid cursor or request_id — returns not_found or error status","Payment not confirmed on-chain — 402 response before results are returned","Search still processing — status is pending/in_progress with empty results array, poll with request_id","GET /person/search returns 404 — only POST is supported on this live endpoint"],"whenToPreferThis":"Use this endpoint when you need to find people using a natural-language description rather than structured filters alone, especially when you want contact information (emails, phones), AI-generated insights, or profile relevance scores. Prefer the premium tier for richer results; use light for faster, cheaper lookups. Use cursor or request_id continuation to paginate beyond the initial results without paying for a full re-search.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:31:20.398Z","isFirstParty":false}