{"uid":"cap_UhnUocqBLW9OTVq3QuxVM","slug":"fullenrich-people-search-e861db3c","name":"FullEnrich People Search","description":"FullEnrich People Search — contacts by domain, seniority, title, location, skills. $0.05/query. Requires at least one search filter; limit/offset alone → 400.","url":"https://stable-enrich-git-shafu-stableenrich-fulle-a23f83-merit-systems.vercel.app/api/fullenrich/people-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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["limit","offset"],"properties":{"limit":{"type":"integer","default":3,"maximum":100,"minimum":1,"description":"Max people to return. Default 3; raise when you need more (flat $0.05/query regardless of limit)."},"offset":{"type":"integer","default":0,"maximum":9007199254740991,"minimum":0},"search_after":{"type":"string","description":"Cursor token for pagination beyond offset 10,000."},"excludeFields":{"type":"array","items":{"type":"string"}},"person_skills":{"type":"array","items":{},"description":"Filter list. Plain strings and {\"value\":\"...\"} objects are both accepted."},"person_locations":{"type":"array","items":{},"description":"Pair with current_company_domains — location alone is very broad. Some domains (e.g. figma.com) return zero people regardless of filters."},"past_company_domains":{"type":"array","items":{},"description":"Filter list. Plain strings and {\"value\":\"...\"} objects are both accepted."},"current_company_domains":{"type":"array","items":{},"description":"Filter list. Plain strings and {\"value\":\"...\"} objects are both accepted."},"current_position_titles":{"type":"array","items":{},"description":"Exact title match only — far fewer results than seniority. Use for precise title needs, not population queries."},"current_position_years_in":{"type":"array","items":{"type":"object","properties":{"max":{"type":"number"},"min":{"type":"number"}},"additionalProperties":false}},"current_position_seniority_level":{"type":"array","items":{},"description":"Preferred for population queries (e.g. all VPs). Use exact FullEnrich enum values (C-level, VP, Head, Founder) — not Apollo-style c_suite. Invalid values return 400. Avoid Director in domain-scoped searches — too common. See docs.fullenrich.com/api/v2/general/enums#seniority."},"current_company_days_since_last_job_change":{"type":"array","items":{"type":"object","properties":{"max":{"type":"number"},"min":{"type":"number"}},"additionalProperties":false},"description":"Days since last job change in FullEnrich graph (not necessarily current role start). Prefer wider ranges (500-1000). Use with one or two other filters max."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DIgl7mLcCraesY38Lpbf8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for professional contacts by domain, seniority, job title, location, or skills using the FullEnrich people search API.","exampleAgentPrompt":"Find me up to 10 VP-level contacts in the marketing department at companies using the domain stripe.com — filter by seniority 'vp' and return their names, titles, and emails.","exampleUseCases":[{"title":"B2B lead list building by domain","prompt":"Pull me a list of up to 20 director and VP-level people at acme.com — I need their names, job titles, and contact info so I can start an outbound campaign."},{"title":"Recruiting outreach to engineers","prompt":"Find software engineers with machine learning skills at openai.com — show me up to 15 results, mid to senior level, so I can reach out about a job opportunity."},{"title":"Targeting executives by city for a conference","prompt":"I'm hosting an event in New York — can you find C-suite executives based in New York City across any company, up to 25 contacts, so I can send personal invites?"}],"resultDescription":"Returns a list of professional contact records matching the search filters, including fields such as full name, job title, seniority level, company domain, location, skills, and email address where available. Results are paginated via limit and offset parameters.","failureModes":["400 error if no search filter is provided (limit/offset alone are insufficient)","Empty results if no contacts match the given filter combination","Incomplete contact records if email or certain fields are unavailable for matched individuals","Rate limiting or quota errors if usage volume is high","Invalid domain format may return zero results"],"whenToPreferThis":"Choose this endpoint when you need to search for professional contacts by company domain, job title, seniority, location, or skills and want structured contact records back. It is ideal for B2B lead generation, recruiting outreach, and sales prospecting workflows where you need to filter a people database by professional attributes rather than looking up a single known individual by name or email.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:41.797Z","isFirstParty":false}