Start a quick match ($2.50, one role, minutes)

The single best current role for this candidate, with a tailored CV and cover letter. Same request body as /api/v1/searches. Paid in USDC via x402: call it unpaid to receive the challenge, then retry with a PAYMENT-SIGNATURE header. Poll GET /api/v1/searches for status. Quick credits cannot pay for a full search, and vice versa.

post/api/v1/quick-searches

Request

  • Base URL: https://jobherder.com
  • URL: https://jobherder.com/api/v1/quick-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

Quick match queued

okboolean
run_idstring
statusstring
plan'agent_quick'
target_jobs1
credits_remaininginteger

Changes

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