IntroductionQuickstartAuthenticationPaginationRate Limit
Free countPreview data mode

Search endpoints

Job Search POSTCompany Search POSTTechnographics POST

Account endpoints

Get Credit Balance GETGet Credits Consumption GET

Other

TheirStackTheirStack Logo
Log inSign up
DocumentationAPI ReferenceWebhooksDatasetsMCPGuides
Features

Free count

Discover how to use TheirStack's free count feature to estimate matching records in Job and Company Search endpoints without spending API credits.

Our Job Search and Company Search endpoints include a free count feature that allows you to estimate the number of records that match your search criteria without consuming API credits.

Steps to use free count

To effectively use the Free Count feature, follow these steps:

  1. Enable Total Results: Set the include_total_results field to true. This will ensure that the total number of matching records is included in the response.
  2. Blur Company Data: Set the blur_company_data field to true. This makes the request free for you. When blur_company_data is true, all company identifiers are blurred and the request doesn't cost any credits.
  3. Limit Results: Set the limit field to 1. This minimizes the data returned and makes the request faster, focusing solely on the count.

By following these steps, you can efficiently estimate the number of records that match your search criteria without consuming any API credits.

How is this guide?

Last updated on

Rate Limit

Discover how TheirStack API rate limits work across free and paid tiers, with sliding windows, IETF-compliant headers, and retry best practices.

Preview data mode

Discover how to use preview data mode in TheirStack API to show blurred job and company results without consuming credits. Save API calls today.

On this page

Steps to use free count