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. limit defaults to 10, so a request without it returns at most 10. Send limit: 0 to get the total match count, which is the cost of exporting every match. Do not send limit: null; it is not accepted.

Response

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

Example

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