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

Let people who build apps by prompting an AI app builder add lead search, contact enrichment or business-card capture without signing up for a data vendor themselves.

Get a free API key + $5 Get a sample run

Free API key
No credit card
Run your sample

A selection of teams that run this job on Forager · plus other teams on Forager

Uses POST /person_role_search/, POST /person_detail_lookup/, POST /organization_search/, POST /person_contacts_lookup/phone_numbers/ · People search API reference

What it costs: 15 credits per mobile found · 5 credits per email found. A mobile or email lookup that returns nothing costs 0 credits. Enrichment and search are charged per request: credit pricing.

How the data flows

3 inputs → People search + Person enrichment + Company enrichment + Work emails + Mobile numbers → 4 fields sample data

01 · Inputs

Natural-language prompt

heads of finance at Series B fintechs in Germany

Company

Example Inc.

Company domain

example.com

02 · Forager

People search + Person enrichment + Company enrichment + Work emails + Mobile numbers POST /person_role_search/

Match found

03 · Outputs

Jane ExampleVP Revenue Operations · Example Inc.

company: Example Inc.
work email: jane@example.com
phone number: +1 (415) 555-0142
name: Jane Example
title: VP Revenue Operations

4 fields in the responseexample data

Steps

Register an integration that wraps POST /person_role_search/, POST /person_detail_lookup/ and POST /organization_search/ with typed schemas
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/
Bill builders in platform credits and show credits used per call

import json, os, requests

BASE = "https://api-v2.forager.ai/api/{account_id}/datastorage"
HEADERS = {"X-API-KEY": os.environ["FORAGER_KEY"]}
body = json.load(open("request.json"))  # request fields: see the API reference

# 1. Register an integration that wraps POST /person_role_search/, POST
# /person_detail_lookup/ and POST /organization_search/ with typed schemas
r1 = requests.post(f"{BASE}/person_role_search/", headers=HEADERS, json=body)
r2 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body)
r3 = requests.post(f"{BASE}/organization_search/", headers=HEADERS, json=body)

# 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
r4 = requests.post(f"{BASE}/person_contacts_lookup/phone_numbers/", headers=HEADERS, json=body)

# 3. For card or badge capture apps, OCR the name and company and resolve
# the person with POST /person_detail_lookup/
r5 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body)

# 4. Bill builders in platform credits and show credits used per call

# 1. POST /person_role_search/
curl -X POST \
  https://api-v2.forager.ai/api/{account_id}/datastorage/person_role_search/ \
  -H "X-API-KEY: $FORAGER_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

# 2. POST /person_detail_lookup/
curl -X POST \
  https://api-v2.forager.ai/api/{account_id}/datastorage/person_detail_lookup/ \
  -H "X-API-KEY: $FORAGER_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

# 3. POST /organization_search/
curl -X POST \
  https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/ \
  -H "X-API-KEY: $FORAGER_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

# 4. POST /person_contacts_lookup/phone_numbers/
curl -X POST \
  https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/ \
  -H "X-API-KEY: $FORAGER_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Generated from the recipe stepsRequest fields: API reference

Run it yourself: People search API reference

Get a free API key + $5 Get a sample run

Free API key
No credit card
Run your sample

Inputs and outputs

Inputs	Outputs
natural-language app prompt	`person`
name + company	`company`
company domain	`work_email`
	`phone_number`

Questions about this recipe

Which people data API can I plug into an AI app builder?

This recipe uses Forager People search, Person enrichment, Company enrichment, Work emails and Mobile numbers. People search: Find the people who hold a role at target companies, filtered by title, seniority, department and location. Let people who build apps by prompting an AI app builder add lead search, contact enrichment or business-card capture without signing up for a data vendor themselves.

What does it cost to offer people and company data as a built-in integration in an AI app builder?

People search: people search 1 credit per request and people search: role details 1 credit per request, charged whether or not data comes back. Person enrichment: 1 credit per request, charged whether or not data comes back. Company enrichment: 1 credit per request, charged whether or not data comes back. Work emails: 5 credits per work email found, and a work email lookup that finds nothing costs 0 credits. Mobile numbers: 15 credits per mobile number found, and a mobile number lookup that finds nothing costs 0 credits. Growth's 8,250 monthly credits cover 550 mobiles, 1,650 emails or 8,250 search requests, or a mix. Self-serve plans are Starter, Growth, Pro and Scale. See plans and prices

What do I need to run this recipe, and what comes back?

You send company domain, name + company and natural-language app prompt. You get back company, person, phone_number and work_email, as JSON. You also need a Forager API key, which comes with a free account.

How do I add B2B contact enrichment to an app I built with an AI coding tool?

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

Is there a free way to try Forager on this workflow?

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.

When should I run this workflow?

When a user prompts the app builder for a CRM, lead-gen or networking app that needs real people and company data. Builders ship data-backed apps in days instead of wiring vendors themselves.

Which Forager products does this recipe use?

People search, person enrichment, company enrichment, work emails and mobile numbers. People search: find the people who hold a role at target companies, filtered by title, seniority, department and location. Person enrichment: a full professional profile for a person from a LinkedIn URL, email or phone: experience, education, skills and contact channels.

How accurate is Forager data?

Forager ranked #1 of 10 in Clay's 2026 test of mobile data providers, by quality score: Clay's measure of how likely a dialled number reaches the right person. 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 do I add contact enrichment to a vibe coded app?

Which tools can run this workflow?

Native in Clay and Zapier, partner-built in Deepline and Cargo and called through the API from your own code, Make and n8n. Or call the endpoints in the steps above from your own code with one API key.

How many steps is this workflow?

4 steps: register an integration that wraps POST /person_role_search/, POST /person_detail_lookup/ and POST /organization_search/ with typed schemas, 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/ and bill builders in platform credits and show credits used per call.

Is there a contract or minimum commitment?

No contract to start: a free account comes with $5 in credits. To keep using Forager, choose a monthly or yearly plan. Monthly plans cancel anytime and unused credits roll over; yearly plans grant all credits upfront and cost 10% less. Larger volumes are agreed with our team.

A selection of teams that run this job on Forager · plus other teams on Forager

Clay
- GTM workflow builders
Selected use case: Forager mobile numbers, emails and people data inside Clay tables.
Juicebox
- AI candidate sourcing
Selected use case: Forager data behind its PeopleGPT search and sourcing agents.
Nooks
- Power & parallel dialers
Selected use case: mobile numbers inside their dialer.
Emergent Labs
- Agent builders
AI app-building platform where agents design, code and deploy full-stack apps.
Airscale
- Waterfall enrichment
Selected use case: a Forager step in its mobile number waterfall.
HubSpot
- CRM add-ons
Selected use case: enriching contact and company records with people, company and job-posting data.
BetterContact
- Waterfall enrichment
Selected use case: a Forager step in its waterfall for mobile numbers.
Freckle
- GTM workflow builders
Selected use case: Forager as a selectable mobile number provider in its waterfalls.

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

How the data flows

Steps

Inputs and outputs

Questions about this recipe

Which people data API can I plug into an AI app builder?

What does it cost to offer people and company data as a built-in integration in an AI app builder?

What do I need to run this recipe, and what comes back?

How do I add B2B contact enrichment to an app I built with an AI coding tool?

Is there a free way to try Forager on this workflow?

When should I run this workflow?

Which Forager products does this recipe use?

How accurate is Forager data?

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

Which tools can run this workflow?

How many steps is this workflow?

Is there a contract or minimum commitment?

More recipes for agent builders

Give coding agents typed people and company data tools

Add Forager as a waterfall step in an agent's contact tool

Ground an agent's account research with company enrichment

Offer people search as an agent tool

Add a mobile-number slot to a multi-provider enrichment waterfall

Detect CRM contacts who changed jobs and alert on moved champions

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