Changelog

New features, improvements, and fixes to the Blitz API.

Subscribe
Breaking

`remaining_credits` on the key-info endpoint is renamed `records_remaining`

GET /v2/account/key-info now returns your balance under records_remaining instead of remaining_credits. The new name matches fair_usage.records_remaining and the x-records-remaining header. Update any client that reads remaining_credits.

Endpoints/v2/account/key-info
Breaking

The `x-credit-*` response headers are replaced by `x-records-*`

x-credit-cost and x-credit-remaining are removed. Every /v2 response now returns x-records-used and x-records-remaining instead, carrying the same values. Update any client that reads the old header names.

Improvement

Every response now reports your record usage and rate limit

Every /v2 endpoint now returns a fair_usage block on success, and on the 402 insufficient-balance error. fair_usage.records_used gives the records this request consumed, fair_usage.records_remaining the records left on your plan and fair_usage.next_reset_at when your balance resets. fair_usage.rate_limit gives requests_per_second and remaining_this_second, and is absent on /v2/account/key-info, which is not rate limited. fair_usage.request_id gives an id you can quote to support.

Improvement

Reverse phone lookup now costs 1 credit

A successful /v2/enrichment/phone-to-person reverse phone lookup now costs 1 credit on success (previously 5).

Endpoints/v2/enrichment/phone-to-person
Announcement

Added TAM By Jobs and the changelog endpoint to the SDKs

blitz-api-js and blitz-api-py SDKs now expose company.tam_by_jobs() - build a Total Addressable Market of companies from live hiring signals - and changelog.list() to fetch this changelog.

Breaking

TAM By Jobs `min_per_company` maximum lowered to 25

The job.min_per_company floor on /v2/company/tam-by-jobs now accepts a maximum of 25 (previously 100). Requests passing a higher value are rejected. Lower it to 25 or below.

Endpoints/v2/company/tam-by-jobs
Fix

Company search cursor now returns every matching company

When paging through /v2/search/companies with cursor, the walk could stop well short of total_results, skipping matching companies that were never returned across the full set of pages. Cursor pagination now covers the complete result set, so you receive every company that matches your filters.

Endpoints/v2/search/companies
Improvement

Search pages now reliably return the full result count

Company and job search pages now fill to your requested max_results, so pages no longer come back short. If the search has a partial failure, these endpoints now return 503 (retriable) instead of a truncated page that looks like the end of results.

Endpoints/v2/search/companies/v2/jobs/search/v2/jobs/company
Improvement

TAM By Jobs 50k limit now counts returned companies

The 50,000-company pagination cap on TAM By Jobs now counts companies actually returned to you.

Endpoints/v2/company/tam-by-jobs
Feature

Added TAM By Jobs endpoint

You can now find companies from their job offers on Linkedin at POST /v2/company/tam-by-jobs.

Endpoints/v2/company/tam-by-jobs
Feature

Added a public changelog endpoint

You can now fetch the Blitz API changelog at GET /changelog — no API key required. Use days to limit to recent changes and limit to cap the count.

Endpoints/changelog