Skip to main content
POST
Estimate Search Cost
Returns the number of jobs a query would consume from your jobs allowance: min(limit, total matches) — the same rule Export Jobs bills by. The estimate itself costs 0 and keeps working after you hit a plan cap, so you can size a query before spending on it.
Requires an API key. Web (JWT) sessions receive 403.

Endpoint

Request Body

Accepts exactly the same body as Search Jobs: every filter plus page and limit. Omit limit to estimate the cost of exporting every match.

Response

number
Jobs that would be charged: limit when the query matches at least that many, otherwise the total match count. With no limit, the total match count.

Example

Check cost against Hirebase-Usage-Included-Remaining from your last response (or client.last_usage.included_remaining in the SDK). On hard-capped plans a request that could exceed the remaining allowance is refused up front — see Usage Headers & Metering.