anzscofinder API

Turn a CV into ranked ANZSCO occupation codes for Australia & New Zealand — with pros/cons and the structured CV. Base URL https://api.anzscofinder.com. Full interactive reference: Swagger →

Authentication

Every request needs a Bearer key (ak_live_… / ak_test_…), shown once at signup. New accounts start with 50 free credits.

# header on every call
Authorization: Bearer ak_live_your_key

Quickstart

Submit a CV, poll for the ranked result. Jobs are asynchronous.

# 1 — classify a CV (Australian ANZSCO 2022)
curl -X POST https://api.anzscofinder.com/v1/jobs \
  -H "Authorization: Bearer ak_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "source_text": "Jane Smith — Registered Nurse, 8 yrs ICU…",
        "model_tier": "sydney", "country": "au", "anzsco_version": "2022" }'
# → { "id": "a1b2…", "status": "queued" }

# 2 — poll until done
curl https://api.anzscofinder.com/v1/jobs/a1b2… -H "Authorization: Bearer ak_live_your_key"

Classify — POST /v1/jobs

One input + routing + optional controls.

Each ranked occupation comes back with confidence, strengths (pros), gaps (cons), an explanation, traceable evidence, and sibling alternatives — plus a result-level overview and the PII-free profile (the structured CV, so you can validate what we understood).

{ "result": {
    "overview": "Acute-care RN; strongest fit is hospital-based nursing.",
    "ranked": [
      { "rank": 1, "code": "254418", "title": "Registered Nurse (Medical)", "confidence": 0.92,
        "strengths": ["8 yrs ICU at a tertiary hospital", "ventilator + medication management"],
        "gaps": ["no AHPRA registration evidenced (normal offshore)"],
        "explanation": "Duties and setting map to medical-ward nursing.",
        "alternatives": [{ "code": "254499", "title": "Registered Nurses nec" }] }
    ],
    "profile": { "...structured CV..." },
    "disclaimer": "ANZSCO occupational classification only; not migration, visa or legal advice."
} }

Extract only — POST /v1/extractions

CV in, structured PII-free CV out, no classification (1 credit). The "just parse my CV" option.

curl -X POST https://api.anzscofinder.com/v1/extractions \
  -H "Authorization: Bearer ak_live_your_key" -H "Content-Type: application/json" \
  -d '{ "source_text": "…CV text…" }'
# → poll GET /v1/extractions/{id} → { "status":"succeeded", "profile": {…} }

Errors & limits

Credits: extract = 1, Falcon = 2, Sydney = 12. You're only charged on success.

Integrations