Size a market with search totals before a client engagement

Give a GTM agency or consultancy a fast count of the companies and buyers in a client's ICP, to scope and price an engagement before building any list.

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

Free API key
No credit card
Run your sample

Uses POST /organization_search/totals/, POST /person_role_search/totals/ · Company enrichment API reference

What it costs: Charged per request: credit pricing.

How the data flows

2 inputs → Company enrichment + People search → 3 fields sample data

01 · Inputs

Client ICP

Founders · e-commerce brands · US

Title

Chief Operating Officer

02 · Forager

Company enrichment + People search POST /organization_search/totals/

Match found

03 · Outputs

Alex SampleChief Operating Officer · Example Inc.

company count: Example Inc.
buyer count: 12
name: Alex Sample
title: Chief Operating Officer
mobile: +1 (212) 555-0199
work email: alex@example.com

3 fields in the responseexample data

Steps

Count matching companies with POST /organization_search/totals/ (industries, locations, employees_start, employees_end)
Count buyers with POST /person_role_search/totals/ (role_title, organization filters) to get total_persons and total_organizations
Repeat for narrower and wider ICP versions to show the trade-off
Put the counts in the proposal and price the list and campaign volume from them

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. Count matching companies with POST /organization_search/totals/
# (industries, locations, employees_start, employees_end)
r1 = requests.post(f"{BASE}/organization_search/totals/", headers=HEADERS, json=body)

# 2. Count buyers with POST /person_role_search/totals/ (role_title,
# organization filters) to get total_persons and total_organizations
r2 = requests.post(f"{BASE}/person_role_search/totals/", headers=HEADERS, json=body)

# 3. Repeat for narrower and wider ICP versions to show the trade-off

# 4. Put the counts in the proposal and price the list and campaign volume
# from them

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

# 2. POST /person_role_search/totals/
curl -X POST \
  https://api-v2.forager.ai/api/{account_id}/datastorage/person_role_search/totals/ \
  -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: Company enrichment 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
client ICP (industries, locations, sizes)	`company count`
buyer titles	`buyer count`
	`counts per ICP version`

Questions about this recipe

How can I count how many companies and buyers match an ICP?

Count matching companies with POST /organization_search/totals/ (industries, locations, employees_start, employees_end). Count buyers with POST /person_role_search/totals/ (role_title, organization filters) to get total_persons and total_organizations.

What does it cost to size a market with search totals before a client engagement?

Company enrichment: 1 credit per request, charged whether or not data comes back. People search: people search 1 credit per request and people search: role details 1 credit per request, charged whether or not data comes back. Growth's 8,250 monthly credits cover 8,250 company lookups, 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 buyer titles and client ICP (industries, locations, sizes). You get back buyer count, company count and counts per ICP version, as JSON. You also need a Forager API key, which comes with a free account.

Which API returns totals for a people or company search?

This recipe uses Forager Company enrichment and People search. Company enrichment: Firmographics for a company from its domain or name: industry, headcount, locations, growth and open roles. Give a GTM agency or consultancy a fast count of the companies and buyers in a client's ICP, to scope and price an engagement before building any list.

Can I test company enrichment for free?

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 prospective client asks how big their reachable market is, or the agency scopes a proposal. Agencies scope work on the real size of the market, and clients see the numbers behind the plan.

Which Forager products does this recipe use?

Company enrichment and people search. Company enrichment: firmographics for a company from its domain or name: industry, headcount, locations, growth and open roles. People search: find the people who hold a role at target companies, filtered by title, seniority, department and location.

How do I know the data is right?

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 many companies match my ICP?

Count matching companies with POST /organization_search/totals/ (industries, locations, employees_start, employees_end). Repeat for narrower and wider ICP versions to show the trade-off.

Which tools can run this workflow?

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

How many steps is this workflow?

4 steps: count matching companies with POST /organization_search/totals/ (industries, locations, employees_start, employees_end), count buyers with POST /person_role_search/totals/ (role_title, organization filters) to get total_persons and total_organizations, repeat for narrower and wider ICP versions to show the trade-off and put the counts in the proposal and price the list and campaign volume from them.

Do I need a subscription?

Not to test: 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.

Size a market with search totals before a client engagement

How the data flows

Steps

Inputs and outputs

Questions about this recipe

How can I count how many companies and buyers match an ICP?

What does it cost to size a market with search totals before a client engagement?

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

Which API returns totals for a people or company search?

Can I test company enrichment for free?

When should I run this workflow?

Which Forager products does this recipe use?

How do I know the data is right?

How many companies match my ICP?

Which tools can run this workflow?

How many steps is this workflow?

Do I need a subscription?

More recipes for consultancies

Prospect DTC and Shopify brand founders for e-commerce growth agencies

Build foreign distributor and importer lists for export development

Trigger client outbound campaigns from hiring signals

Turn new company incorporations into contactable founders

Find companies with large engineering teams on a legacy stack

Find small companies hiring their first IT person for managed-services pitches

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