# People Search API: Find B2B Contacts by Title — Ravn

Canonical: https://askravn.com/features/people-search-api

People search API

# Build the list your agent needs.

Ask for "Heads of Design at fintechs in New York with 50 to 500 people" and get profiles back with verified work emails. Lists page with a cursor, so agents can keep going.
[Start free: 1,000 lookups](https://askravn.com/#start) [Read the docs](https://askravn.com/docs#search_people)

How it works
## What happens on every call.
The same tool answers over the REST API, the MCP server and the CLI.

- / 01
### Filter like a person would
Title, company, domain, location, seniority, industry, department and company size. Lists are OR within a field, AND across fields.
- / 02
### Your own provider key
`search_people` runs on your own People Data Labs key. Ravn makes the call and stores nothing; without a key it returns `403 provider_key_required`.
- / 03
### Suppression first
Opted-out people are removed before anything is returned.
- / 04
### One lookup per call
A search counts as one lookup on your Ravn plan, and a miss is free.

Call it
## One request. One answer shape.
Branch on `status`. A miss returns `not_found` and costs nothing. In Claude, just ask in plain English and it picks `search_people` for you.

```
curl https://api.askravn.com/v1/tools/search_people \
-H "Authorization: Bearer $RAVN_API_KEY" \
-d '{"title": ["Head of Design"], "company_domain": ["linear.app"], "limit": 5}'

{ "status": "ok",
"results": { "results": [ { "full_name": "…", "title": "Head of Design",
"seniority": "director", "business_email": "…",
"company": { "name": "Linear", "domain": "linear.app" } } ],
"total": 1, "next_cursor": null },
"metadata": { "lookups_used": 1 } }
```

FAQ
## Questions about search_people.
[All questions →](https://askravn.com/faq)
How is it billed?A search is one lookup on your Ravn plan. The people data comes from your own People Data Labs account, so Ravn never marks up or resells records.Can Claude run searches for me?Yes. Connect the MCP server and ask in plain English. It chooses the filters and pages through results.Related tools?`search_business_profile_by_name` finds one person by name and company; `search_linkedin_profile` returns their LinkedIn URL.What can I not use it for?Credit, employment, insurance or housing decisions, or contacting anyone who opted out. See the [terms](https://askravn.com/terms).

## More tools, same key.
Every tool shares one account, one plan and one answer shape. [See pricing →](https://askravn.com/pricing)

- [Phone Validation & Carrier Lookup APIValidate phone numbers and check the live carrier and line type: mobile, landline or VoIP.](https://askravn.com/features/phone-validation-api)
- [Reverse Email Lookup API: Email to PersonTurn an email into a business profile: name, title, company, location and LinkedIn.](https://askravn.com/features/reverse-email-lookup)
- [Website Scraper API: Company Data as JSONRead any company website into JSON: emails, phone numbers, socials, team members with titles, address, tech stack and whether it's live..](https://askravn.com/features/website-scraper-api)
- [Company Enrichment API: Domain to Company DataEnrich a domain into a company profile: size, industry, founded year, location, socials and tech stack.](https://askravn.com/features/company-enrichment-api)
- [Email Finder API: Find Work Emails by NameFind a work email from a name and company domain.](https://askravn.com/features/email-finder-api)
- [Email Verification API for AI AgentsVerify emails before you send: syntax, MX, disposable, role and catch-all checks with an A–F risk score.](https://askravn.com/features/email-verification-api)