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.
TAM By People (POST /v2/company/tam-by-people) builds a total addressable market (TAM) from headcount signals. It takes the same filters as Find People, plus a people.linkedin_url filter and without the include_active_jobs and include_past_jobs flags (only current jobs count), but returns the distinct companies employing the matching people (deduplicated), each with its matched_people count. Use it to size the set of accounts that actually employ your buyer persona.
1 record per result
Combine people-level filters (title, job description, function, level, location, education) with company-level firmographics (industry, size, revenue, funding, HQ) in the same request.
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. Pagination stops at 50,000 companies: the page that reaches this cap returns cursor: null, like a normal end. To go further, split the search into narrower filters that each stay under the cap.
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.

TAM By People API: product overview

Use cases, coverage, and the endpoints it chains with.

Authorizations

x-api-key
string
header
required

Your BlitzAPI 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.