Automate Resume Screening With Two API Calls
Screening is not one problem — it is two. First turn every resume into data, then rank that data against the job. Each has a dedicated endpoint; wired together they replace the recruiter's least favourite afternoon.
14-day trial · 100,000 words included · No credit card
A resume screening API automates the first review pass over an applicant pool: extract each candidate's data, score it against the job description, and return a ranked shortlist with reasons. SharpAPI implements this as two composable endpoints — parse_resume and resume_job_match_score.
The screening loop, end to end
The pattern is the same whether the pool holds 20 applicants or 2,000, and because both endpoints are async, the whole pool runs in parallel:
for each application in pool:
job = POST /hr/resume_job_match_score # file + job description
scores[application] = poll(job.status_url) # 20 dimensions + reasons
shortlist = sort(scores, by="overall_match", desc) # recruiters start at the top
review(shortlist[:10].explanations) # written evidence per score
Need the structured profile too — for the candidate record, search, or dedupe? Run parse_resume on the same file and store the 50+ field JSON alongside the scores.
What separates screening from keyword filtering
Keyword filters reject the developer who wrote “built REST services in Django” for a “Python backend” role. Semantic scoring reads meaning: the match-score endpoint evaluates 20 dimensions of fit, weights must-haves at 3× nice-to-haves, and explains each headline number in writing. The difference is measured in good candidates that stop falling through — more in semantic vs keyword matching.
Screening you can put in front of a regulator
Automated screening is exactly what NYC Local Law 144 and the EU AI Act regulate. Two properties of this pipeline do the heavy lifting: PII never reaches the scoring model — names, ages, nationalities and photos are stripped after parsing — and every score ships with a written explanation. Ranked, and defensible. The compliance details live in our AI screening law guide.
Sizing the workload
| Scenario | Calls | Pattern |
|---|---|---|
| New job posting, 200 applicants | 200 | Batch-submit match-score jobs, webhook per result, sort by overall_match |
| Staffing bench × new client brief | 1/candidate | Bench resumes are already parsed; score stored profiles against the brief text |
| Legacy database migration | 10k+ | Bulk parse_resume first (see the bulk parsing guide), then score on demand later |
| Job board “fit badge” | 1/apply | Score at application time; show the badge, store the explanations |
Questions, answered
What is a resume screening API?
An API that automates the first pass over an applicant pool: it converts each resume into structured data, scores it against the job description, and returns a ranked list — so recruiters open a shortlist instead of a pile of PDFs.
How do I rank 200 applicants with it?
Loop the pool through the match-score endpoint — each call takes the resume file and the job description and comes back with 20 scores. Sort by overall_match, review the explanations for the top of the list, done. The async design means all 200 jobs run in parallel.
Can I control what the screening prioritizes?
Yes — the context parameter accepts up to 5,000 characters of instructions: emphasize a must-have certification, de-emphasize location, credit adjacent experience. The weighting adjusts and the explanations reflect your criteria.
Is automated resume screening legal?
Increasingly regulated, yes — NYC Local Law 144 requires bias audits and the EU AI Act classifies hiring AI as high-risk. Two design choices here help: PII is stripped before scoring, and every score carries a written explanation a recruiter or auditor can review.