Skip to main content
POST
TAM By Jobs
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 Jobs (POST /v2/company/tam-by-jobs) builds a total addressable market (TAM) from hiring signals. Filter live job postings the same way you would with Search Jobs and get back the distinct companies hiring for those roles (deduplicated), each with its matched_jobs count. Use it to surface accounts that match your ICP and are actively hiring.
1 record per result
Combine job-level filters (title, description, field, seniority, employment type, work arrangement, location, date posted) with company-level firmographics (industry, size, headcount, HQ, mail provider) 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.
job.min_per_company floors the matched-jobs count, so only companies with at least that many matching postings are returned (max 25, 0 = unset). When it filters heavily, a page may come back partial: keep paging until cursor is null.
Filter logic: all filters combine with AND. Multiple values within a single include list combine with OR: two values in job.title.include return companies hiring for either role. 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 Jobs 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

job
object

Job-level search criteria

company
object

Company-level firmographic criteria (enriched from the internal company record)

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

Response for status 200

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.