$5 free Limited time. Sign up to activate. Get your $5 →
AI SDRs and agent builders · Agent frameworks and builders

People search API for AI agent builders

Find the right person.

What agent builders need from people search, what Forager returns, and how teams like yours test it.

3 recipes use people search for agent frameworks and builders.

  • $5 free credits
  • 800M+ people
  • 65M+ companies

A selection of agent builders using Forager for people search · plus other teams on Forager

  • Emergent Labs
  • Dynasty Financial Partners
  • Coram
  • Powerweave Group
  • Jeeva AI
  • Bitscale
  • Disguise
  • Velox
For agent frameworks and builders
The job
Let GTM engineers and developers build production enrichment workflows by prompting a coding agent against typed endpoints, or add a people endpoint to their own web-data API.
When
A developer asks a coding agent to 'enrich new sign-ups with role and company and route them'.
Outcome
GTM engineers ship production workflows in minutes and developers enrich sign-ups and leads with one API key.
Lead recipe 1

Give coding agents typed people and company data tools

When to use it: A developer asks a coding agent to 'enrich new sign-ups with role and company and route them'.

  1. Publish typed schemas for person_role_search, person_detail_lookup, reverse lookup, organization_search and job_search
  2. Coding agent generates the workflow code and calls endpoints with one API key
  3. Use _totals endpoints to estimate cost before paginating
  4. Deploy as a scheduled job or webhook handler
InputsOutputs
developer promptgenerated workflow
API keyenriched records
typed endpoint schemas
Lead recipe 2

Offer people and company data as a built-in integration in an AI app builder

When to use it: A user prompts the app builder for a CRM, lead-gen or networking app that needs real people and company data.

Show the steps
  1. Register an integration that wraps POST /person_role_search/, POST /person_detail_lookup/ and POST /organization_search/ with typed schemas
  2. When generated code needs contacts, call /person_contacts_lookup/work_emails/ and POST /person_contacts_lookup/phone_numbers/ through the platform's metered key
  3. For card or badge capture apps, OCR the name and company and resolve the person with POST /person_detail_lookup/
  4. Bill builders in platform credits and show credits used per call
InputsOutputs
natural-language app promptperson
name + companycompany
company domainwork_email
phone_number
Open the recipe: Offer people and company data as a built-in integration in an AI app builder
Lead recipe 3

Offer people search as an agent tool

When to use it: An agent is asked to find the head of security at a list of companies and start a conversation with each.

Show the steps
  1. Expose a find_people tool that maps the agent's request to POST /person_role_search/ filters: title, seniority, department, location and company
  2. Check the _totals endpoint first so the tool can report how many matches exist before it pages
  3. Return each match as a typed record with person_id, name, title and employer
  4. Let the agent call POST /person_detail_lookup/ for the one or two people it chooses, not the whole result set
InputsOutputs
company domain or nameperson_id
title or seniority filtersfull name
locationtitle
employer
profile fields
Open the recipe: Offer people search as an agent tool
Fields

Fields you get back

  • generated workflow
  • enriched records
  • person
  • company
  • work_email
  • phone_number
  • person_id
  • full name
  • title
  • employer
  • profile fields

From the workflows above. Full field reference: People search and the People search API reference.

Who owns this

Who evaluates people search at agent frameworks and builders, and what they are judged on

  • Product manager who owns the enrichment feature: judged on what users see when they open a record
  • Engineering lead integrating the API: judged on response time and errors they can route on
  • Partnerships or data lead managing vendors: judged on cost per valid result

A selection of agent builders using Forager for people search · plus other teams on Forager

  • Emergent Labs
    • Agent builders

    AI app-building platform where agents design, code and deploy full-stack apps.

  • Dynasty Financial Partners
    • Internal use

    Firm that helps financial advisors build and grow independent practices.

  • Coram
    • Internal use

    Selected use case: mobile numbers for outbound calling.

  • Powerweave Group
    • Internal use

    B2B ecommerce software and managed services provider.

  • Jeeva AI
    • AI SDRs

    Agentic platform of AI digital workers for sales teams.

  • Bitscale
    • GTM workflow builders

    Selected use case: Forager in its contact waterfall for mobile numbers.

  • Disguise
    • Internal use

    Visual experience platform for live events and virtual production.

  • Velox
    • Staffing firms

    Technical staffing firm in the Netherlands.

“Forager leads in accuracy across all regions, Forager's dual strength in accuracy and volume makes it a powerhouse for sales teams that are targeting businesses around the globe.”
ClayStefan K.Data Partnerships
800M+people
65M+companies
How to test it

Test people search on your own sample

  1. Pull a sample. Take profiles your users looked up last week.
  2. Run it. Use a self-serve key, or book a demo and send us the list.
  3. Measure what your users feel. Connect rate for mobiles, bounces for emails, and whether the right person answers.
  • $5 free credits
  • No credit card
  • Run your sample
FAQ

Frequently asked questions

How do AI agent builders use Forager people search?

Let GTM engineers and developers build production enrichment workflows by prompting a coding agent against typed endpoints, or add a people endpoint to their own web-data API. Find the people who hold a role at target companies, filtered by title, seniority, department and location. This page walks through 3 workflows with the exact steps.

What does people search cost for AI agent builders?

People search: people search 1 credit per request and people search: role details 1 credit per request, charged whether or not data comes back. 1,000 search requests use 1,000 credits: about $13 of Starter credits month to month, or about $10 on Pro with yearly billing. Self-serve plans are Starter, Growth, Pro and Scale. See plans and prices

Why do AI agent builders add people search?

Typed people and contact lookups your agents can call, paid per result. Products like yours are judged on whether the agent reached the right person, which is why the cost that counts is per result that reaches the right person. Run your own sample to see what people search returns for your users before you build on it.

Which people and company data APIs work well with coding agents?

The workflow uses Forager People search, Person enrichment, Company enrichment, Job postings API, Work emails, Personal emails and Reverse email lookup. People search: Find the people who hold a role at target companies, filtered by title, seniority, department and location. Let GTM engineers and developers build production enrichment workflows by prompting a coding agent against typed endpoints, or add a people endpoint to their own web-data API.

What do I send, and what comes back?

You send API key, company domain and company domain or name. You get back company, employer, enriched records and full name, from POST /person_role_search/, as JSON.

Can we show Forager data inside our product?

Yes, under platform terms. Self-serve plans cover internal use by your own team. Showing Forager data to your users, or passing records on, is licensed separately: talk to sales about volume and which fields your users need to see.

Am I charged when nothing is found?

Yes. People search is charged per request, whether or not data comes back. Only mobile and email lookups are free when nothing is found, so try your inputs on a small run before you scale.

Is there a free way to try Forager?

Yes. Create a free account at app.forager.ai: it comes with $5 in free credits and an API key, and there is no credit card to sign up. Run it on records you already know, or book a demo and send us a list: we run it and show you what we find.

How do I add contact enrichment to a vibe coded app?

When generated code needs contacts, call /person_contacts_lookup/work_emails/ and POST /person_contacts_lookup/phone_numbers/ through the platform's metered key. For card or badge capture apps, OCR the name and company and resolve the person with POST /person_detail_lookup/.

How do you check data quality?

The test that counts is your own: send a list of profiles you care about. We run it and show you what we find, number by number, so you can measure hit rate and connect rate yourself.

How is a people search API different from searching profiles by hand?

Searching by hand works for a handful of accounts. A people search API filters by title, seniority, department and location across your target companies in one request, returns people your product can act on, and hands off to a contact lookup for the mobile or email.

Does Forager integrate with the tools we already use?

Native in Clay, partner-built in Deepline and Cargo and called through the API from your own code. Everything else connects through the REST API with one API key.

Start building

Put people, company and job data your users can act on inside your product

Send us a list. We run it, show you what we find, then talk volume and terms.

  • $5 free credits
  • No credit card
  • Run your sample
Platforms and teams that build on Forager
  • Clay
  • Juicebox
  • Nooks
  • Andela
  • HubSpot
  • SeekOut