Counting results

Our Job Search and Company Search endpoints return the total number of records that match your search criteria.

How to count matching records

1. Set include_total_results to true, so the response includes the total number of records that match your filters.
2. Set limit to 1, so you get that total back with the smallest possible response.

Don't set blur_company_data. Preview data mode is there to show blurred data to your end users, and it can't be used to count records.

What it costs

You pay for the records the request returns, like in any other search:

• If at least one record matches, the request returns one record and you're charged for it: 1 API credit for a job, 3 API credits for a company.
• If nothing matches, no record is returned and the request costs nothing.

A count costs one record, no matter how big the total is. If you're sizing many searches, that's one record per search, and the searches that return zero results are free.

See credits for how API credits are consumed across endpoints.