Start a paid search (consumes one credit)

post/api/v1/searches

Request

  • Base URL: https://jobherder.com
  • URL: https://jobherder.com/api/v1/searches
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional. Same key replays the original response instead of consuming a second credit.

Request body

cv_jsonobject

The CV as structured data in the JSON Resume schema (jsonresume.org): basics, work, education, skills, projects, certificates, awards, publications, languages, interests. Preferred when you hold the CV as data rather than a file — no need to render a document.

cv_base64string

The CV as a base64-encoded file, up to 10MB.

cv_type'pdf' | 'docx' | 'txt'

Format of cv_base64. Plain text is accepted, so an agent with no document to upload can send the CV as text rather than rendering a PDF.

Response

Search queued

okboolean
run_idstring
statusstring
credits_remaininginteger
order_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.