ravn
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 Read the docs

How it works

What happens on every call.

The same tool answers over the REST API, the MCP server and the CLI.

  1. / 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.

  2. / 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.

  3. / 03

    Suppression first

    Opted-out people are removed before anything is returned.

  4. / 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 →

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.

More tools, same key.

Every tool shares one account, one plan and one answer shape. See pricing →