Skip to main content
POST
TAM By People
Agents & LLMs: a Markdown version of this page is available by appending .md to the URL, and the full documentation index is at llms.txt.
1 record per result
Build a total addressable market (TAM) from headcount signals. Filter people the same way you would with Find People, but instead of individual contacts this endpoint returns the distinct companies employing them (deduplicated), each with its matched_people count. Combine people-level filters (title, function, level, location, education) with company-level firmographics (industry, size, revenue, funding, HQ) to size the set of accounts that actually employ your buyer persona.
Pagination is cursor-based. Pass the cursor returned by each response back into the next request. cursor: null means you’re on the first page; a null cursor in the response means you’ve reached the end.
people.min_per_company floors the matched-people count, so only companies with at least that many matching employees are returned (max 25, 0 = unset). When it filters heavily, a page may come back partial: keep paging until cursor is null.
TAM By People vs TAM By Jobs: By People sizes accounts on who already works there, By Jobs on who they are hiring. Use By People for persona-based ICP sizing, By Jobs for intent.
Filter logic: all filters combine with AND. Multiple values within a single include list combine with OR. Use exclude to filter matches out.

Company search guide

Build an ICP-aligned company list, with a full walk-through and example filters.

Authorizations

x-api-key
string
header
required

Your Blitz API Key. Get one from https://app.blitz-api.ai

Body

application/json
company
object

Company search criteria

people
object

People search criteria for company matching

max_results
number
default:10

Maximum number of results to return

Required range: 1 <= x <= 50
Example:

10

cursor
string | null

Cursor to paginate through the results

Minimum string length: 3
Example:

null

Response

OK

results
object[]
required
results_length
number
required
Example:

3

max_results
number
required
Example:

3

cursor
string | null
required
Example:

null

fair_usage
object

Record usage, rate limit, and tracing data for this request.