
Fact-checked resume tailoring, cover letters, interview prep and keyword gaps for a job posting.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Bearer <key> from a CareerGenius Premium account's Account page. Without a key, the free tier applies.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Writes a cover letter (or a short hiring-manager letter) from the resume for one posting. Every sentence is checked against the resume; unsupported sentences are removed and counted by reason. Returns only a letter, never other text. Review before use. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key).
Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it).
Structured resume. Only what the person really has done: every output is checked against it.
A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused.
The job posting text (preferred).
Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored.
Writes a cover letter (or a short hiring-manager letter) from the resume for one posting. Every sentence is checked against the resume; unsupported sentences are removed and counted by reason. Returns only a letter, never other text. Review before use. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key).
| Argument | Type | Description |
|---|---|---|
| kind | any | |
| resume | object | Structured resume. Only what the person really has done: every output is checked against it. |
| job_url | string | A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused. |
| job_title | string | |
| resume_text | string | |
| company_name | string | |
| on_behalf_of* | object | Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it). |
| posting_text | string | The job posting text (preferred). |
| applicant_name | string | |
| idempotency_key | string | Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored. |
{
"type": "object",
"required": [
"on_behalf_of"
],
"properties": {
"kind": {
"enum": [
"cover-letter",
"hiring-manager-letter"
]
},
"resume": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 80
},
"summary": {
"type": "string",
"maxLength": 3000
},
"headline": {
"type": "string",
"maxLength": 120
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
}
}
},
"maxItems": 6
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"degree": {
"type": "string"
},
"school": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
},
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 8
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"current": {
"type": "boolean"
},
"employer": {
"type": "string"
},
"end_date": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 15
}
},
"description": "Structured resume. Only what the person really has done: every output is checked against it."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"job_title": {
"type": "string",
"maxLength": 120
},
"resume_text": {
"type": "string",
"maxLength": 30000
},
"company_name": {
"type": "string",
"maxLength": 120
},
"on_behalf_of": {
"type": "object",
"required": [
"human_requested",
"resume_is_theirs"
],
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it)."
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"applicant_name": {
"type": "string",
"maxLength": 120
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
}
}Likely interview questions for one job posting, each with an answer outline built ONLY from the resume: every point cites the resume line it comes from and passed the CareerGenius fact check (no invented experience; failing points are removed and listed by reason). Resume as plain text, a PDF/DOCX file (base64) or structured JSON. Counts one call and uses the AI cap. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key). Without a key the whole request is limited to 96 KB.
| Argument | Type | Description |
|---|---|---|
| links | array | |
| resume | object | Structured resume. Only what the person really has done: every output is checked against it. |
| contact | object | |
| job_url | string | A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused. |
| resume_file | object | |
| resume_text | string | A pasted plain-text resume. Read by a fixed layout parser (no AI, nothing added); section headings (Summary, Experience, Education, Skills) help. |
| on_behalf_of* |
Lists the keywords a job posting asks for (named tools, products, credentials, plus any you supply) and which of them the resume shows or does not show. Deterministic, no AI. Not a score and not a prediction of screening or interview outcomes. Without a key: one of the conversation's 10 free keyword/PDF calls. job_url needs a key.
| Argument | Type | Description |
|---|---|---|
| resume | object | Structured resume. Only what the person really has done: every output is checked against it. |
| job_url | string | A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused. |
| keywords | array | |
| resume_text | string | |
| on_behalf_of* | object | Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it). |
| posting_text | string | The job posting text (preferred). |
| idempotency_key | string | Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored. |
The same resume layout as an editable Word (.docx) file, for a person who wants to change it before sending. Returns the file as an embedded resource (base64); nothing is stored. No AI. Counts one call of the monthly allowance. Without a key: one of the conversation's 10 free keyword/PDF calls.
| Argument | Type | Description |
|---|---|---|
| resume* | object | The resume content, exactly as it should appear. Nothing is added, reworded or checked: this tool only lays it out. At most 45,000 characters of JSON. |
| template | any | classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic. |
| page_size | any | Default letter. |
| on_behalf_of* | object | Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it). |
{
"type": "object",
"required": [
"on_behalf_of",
"resume"
],
"properties": {
"resume": {
"type": "object",
"required": [
"contact"
],
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 300
},
"label": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"maxItems": 5,
"description": "http(s) only; printed as text, never as clickable links."
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 80
},
"contact": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"headline": {
"type": "string",
"maxLength": 160
},
"location": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"summary": {
"type": "string",
"maxLength": 3000,
"description": "Line breaks start new paragraphs."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"title"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"title": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"maxItems": 6,
"description": "Other sections (projects, volunteering, awards ...), printed as titled bullet lists."
},
"education": {
"type": "array",
"items": {
"type": "object",
"required": [
"school"
],
"properties": {
"field": {
"type": "string",
"maxLength": 160
},
"degree": {
"type": "string",
"maxLength": 160
},
"school": {
"type": "string",
"maxLength": 160
},
"details": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 6
},
"end_date": {
"type": "string",
"maxLength": 25
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
}
},
"additionalProperties": false
},
"maxItems": 8
},
"experience": {
"type": "array",
"items": {
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 160
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"current": {
"type": "boolean"
},
"employer": {
"type": "string",
"maxLength": 160
},
"end_date": {
"type": "string",
"maxLength": 25
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
}
},
"additionalProperties": false
},
"maxItems": 15
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"date": {
"type": "string",
"maxLength": 25
},
"name": {
"type": "string",
"maxLength": 200
},
"issuer": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"maxItems": 20
}
},
"description": "The resume content, exactly as it should appear. Nothing is added, reworded or checked: this tool only lays it out. At most 45,000 characters of JSON.",
"additionalProperties": false
},
"template": {
"enum": [
"classic",
"modern"
],
"description": "classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic."
},
"page_size": {
"enum": [
"letter",
"a4"
],
"description": "Default letter."
},
"on_behalf_of": {
"type": "object",
"required": [
"human_requested",
"resume_is_theirs"
],
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it)."
}
},
"additionalProperties": false
}Lays out a structured resume as a clean, single-column, ATS-readable PDF (real selectable text, embedded fonts, no images, no tables, no clickable links), letter or A4, at most 3 pages. Returns the file as an embedded resource (base64); nothing is stored. No AI: the text is printed exactly as sent. Counts one call of the monthly allowance. Without a key: one of the conversation's 10 free keyword/PDF calls.
| Argument | Type | Description |
|---|---|---|
| resume* | object | The resume content, exactly as it should appear. Nothing is added, reworded or checked: this tool only lays it out. At most 45,000 characters of JSON. |
| template | any | classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic. |
| page_size | any | Default letter. |
| on_behalf_of* | object | Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it). |
{
"type": "object",
"required": [
"on_behalf_of",
"resume"
],
"properties": {
"resume": {
"type": "object",
"required": [
"contact"
],
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 300
},
"label": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"maxItems": 5,
"description": "http(s) only; printed as text, never as clickable links."
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 80
},
"contact": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"headline": {
"type": "string",
"maxLength": 160
},
"location": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"summary": {
"type": "string",
"maxLength": 3000,
"description": "Line breaks start new paragraphs."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"title"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"title": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"maxItems": 6,
"description": "Other sections (projects, volunteering, awards ...), printed as titled bullet lists."
},
"education": {
"type": "array",
"items": {
"type": "object",
"required": [
"school"
],
"properties": {
"field": {
"type": "string",
"maxLength": 160
},
"degree": {
"type": "string",
"maxLength": 160
},
"school": {
"type": "string",
"maxLength": 160
},
"details": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 6
},
"end_date": {
"type": "string",
"maxLength": 25
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
}
},
"additionalProperties": false
},
"maxItems": 8
},
"experience": {
"type": "array",
"items": {
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 160
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"current": {
"type": "boolean"
},
"employer": {
"type": "string",
"maxLength": 160
},
"end_date": {
"type": "string",
"maxLength": 25
},
"location": {
"type": "string",
"maxLength": 120
},
"start_date": {
"type": "string",
"maxLength": 25
}
},
"additionalProperties": false
},
"maxItems": 15
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"date": {
"type": "string",
"maxLength": 25
},
"name": {
"type": "string",
"maxLength": 200
},
"issuer": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"maxItems": 20
}
},
"description": "The resume content, exactly as it should appear. Nothing is added, reworded or checked: this tool only lays it out. At most 45,000 characters of JSON.",
"additionalProperties": false
},
"template": {
"enum": [
"classic",
"modern"
],
"description": "classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic."
},
"page_size": {
"enum": [
"letter",
"a4"
],
"description": "Default letter."
},
"on_behalf_of": {
"type": "object",
"required": [
"human_requested",
"resume_is_theirs"
],
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it)."
}
},
"additionalProperties": false
}Rewords the resume summary and job bullets for one posting. Every rewrite is checked against the resume; rewrites with unsupported claims (added tools, numbers, seniority, results or employers) are removed and listed in held_back by reason code. Every result has "outcome": which lines were reworded, kept or held back, reason codes (such as NO_CHANGES, AI_KEPT_WORDING, ALL_HELD_BACK, MISSING_KEYWORDS_NOT_ADDABLE), the posting keywords the resume does not show (rewording cannot add them), a plain explanation and next steps. Review before use. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key).
| Argument | Type | Description |
|---|---|---|
| resume* | object | Structured resume. Only what the person really has done: every output is checked against it. |
| job_url | string | A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused. |
| on_behalf_of* | object | Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it). |
| posting_text | string | The job posting text (preferred). |
| idempotency_key | string | Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored. |
One call: give a job posting (text or a public link) and the person's resume (plain text, a PDF or DOCX file in base64, or structured JSON). CareerGenius reads the posting, lists the keywords it asks for and which the resume shows, rewords the summary and bullets for this job, keeps ONLY the rewordings that pass its fact check (no added tools, numbers, titles, results or employers), and returns a clean single-column ATS-readable PDF plus a summary of what changed, what was held back and why. "outcome" explains the result in reason codes and plain words, also when nothing changed: lines reworded / kept / held back, posting keywords the resume does not show, and next steps. Counts one call and uses the AI cap. Review before sending. Without a key: one of the conversation's 2 free AI calls (posting_text only; job_url needs a key). Without a key the whole request is limited to 96 KB.
| Argument | Type | Description |
|---|---|---|
| links | array | |
| resume | object | Structured resume. Only what the person really has done: every output is checked against it. |
| contact | object | |
| job_url | string | A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused. |
| template | any | classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic. |
| object |
| Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it). |
| posting_text | string | The job posting text (preferred). |
| idempotency_key | string | Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored. |
{
"type": "object",
"required": [
"on_behalf_of"
],
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 300
},
"label": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"maxItems": 5
},
"resume": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 80
},
"summary": {
"type": "string",
"maxLength": 3000
},
"headline": {
"type": "string",
"maxLength": 120
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
}
}
},
"maxItems": 6
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"degree": {
"type": "string"
},
"school": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
},
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 8
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"current": {
"type": "boolean"
},
"employer": {
"type": "string"
},
"end_date": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 15
}
},
"description": "Structured resume. Only what the person really has done: every output is checked against it."
},
"contact": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"location": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"resume_file": {
"type": "object",
"required": [
"format",
"content_base64"
],
"properties": {
"format": {
"enum": [
"pdf",
"docx"
]
},
"filename": {
"type": "string",
"maxLength": 200
},
"content_base64": {
"type": "string",
"description": "The file, base64 (at most 1.5 MB decoded with a key; without a key the whole request is limited to 96 KB). PDFs need a text layer (not a scan)."
}
},
"additionalProperties": false
},
"resume_text": {
"type": "string",
"maxLength": 30000,
"description": "A pasted plain-text resume. Read by a fixed layout parser (no AI, nothing added); section headings (Summary, Experience, Education, Skills) help."
},
"on_behalf_of": {
"type": "object",
"required": [
"human_requested",
"resume_is_theirs"
],
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it)."
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"on_behalf_of"
],
"properties": {
"resume": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 80
},
"summary": {
"type": "string",
"maxLength": 3000
},
"headline": {
"type": "string",
"maxLength": 120
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
}
}
},
"maxItems": 6
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"degree": {
"type": "string"
},
"school": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
},
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 8
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"current": {
"type": "boolean"
},
"employer": {
"type": "string"
},
"end_date": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 15
}
},
"description": "Structured resume. Only what the person really has done: every output is checked against it."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60
},
"maxItems": 30
},
"resume_text": {
"type": "string",
"maxLength": 30000
},
"on_behalf_of": {
"type": "object",
"required": [
"human_requested",
"resume_is_theirs"
],
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it)."
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
}
}{
"type": "object",
"required": [
"on_behalf_of",
"resume"
],
"properties": {
"resume": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 80
},
"summary": {
"type": "string",
"maxLength": 3000
},
"headline": {
"type": "string",
"maxLength": 120
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
}
}
},
"maxItems": 6
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"degree": {
"type": "string"
},
"school": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
},
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 8
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"current": {
"type": "boolean"
},
"employer": {
"type": "string"
},
"end_date": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 15
}
},
"description": "Structured resume. Only what the person really has done: every output is checked against it."
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"on_behalf_of": {
"type": "object",
"required": [
"human_requested",
"resume_is_theirs"
],
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it)."
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Optional, keyed calls only (ignored without a key). Retrying with the same key returns the first answer and is not charged twice. Only when you send it, that answer (which can contain text taken from the resume) is kept for 24 hours so the retry can be replayed, then deleted. Without it nothing from the request is stored."
}
}
}| page_size |
| any |
| Default letter. |
| resume_file | object |
| resume_text | string | A pasted plain-text resume. Read by a fixed layout parser (no AI, nothing added); section headings (Summary, Experience, Education, Skills) help. |
| on_behalf_of* | object | Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it). |
| posting_text | string | The job posting text (preferred). |
{
"type": "object",
"required": [
"on_behalf_of"
],
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 300
},
"label": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"maxItems": 5
},
"resume": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"maxItems": 80
},
"summary": {
"type": "string",
"maxLength": 3000
},
"headline": {
"type": "string",
"maxLength": 120
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
}
}
},
"maxItems": 6
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"degree": {
"type": "string"
},
"school": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
},
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 8
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 600
},
"maxItems": 15
},
"current": {
"type": "boolean"
},
"employer": {
"type": "string"
},
"end_date": {
"type": "string"
},
"location": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
},
"maxItems": 15
}
},
"description": "Structured resume. Only what the person really has done: every output is checked against it."
},
"contact": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"location": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"job_url": {
"type": "string",
"maxLength": 2048,
"description": "A public job posting link (Greenhouse, Lever, Ashby, SmartRecruiters, Workday or a page with JobPosting data). Fetched by our job-import engine; private or internal addresses are refused."
},
"template": {
"enum": [
"classic",
"modern"
],
"description": "classic (serif, centred header) or modern (sans-serif, left-aligned). Default classic."
},
"page_size": {
"enum": [
"letter",
"a4"
],
"description": "Default letter."
},
"resume_file": {
"type": "object",
"required": [
"format",
"content_base64"
],
"properties": {
"format": {
"enum": [
"pdf",
"docx"
]
},
"filename": {
"type": "string",
"maxLength": 200
},
"content_base64": {
"type": "string",
"description": "The file, base64 (at most 1.5 MB decoded with a key; without a key the whole request is limited to 96 KB). PDFs need a text layer (not a scan)."
}
},
"additionalProperties": false
},
"resume_text": {
"type": "string",
"maxLength": 30000,
"description": "A pasted plain-text resume. Read by a fixed layout parser (no AI, nothing added); section headings (Summary, Experience, Education, Skills) help."
},
"on_behalf_of": {
"type": "object",
"required": [
"human_requested",
"resume_is_theirs"
],
"properties": {
"human_requested": {
"const": true
},
"resume_is_theirs": {
"const": true
}
},
"description": "Required. You confirm a person asked for this, and the resume is theirs (or they are authorised to use it)."
},
"posting_text": {
"type": "string",
"maxLength": 30000,
"description": "The job posting text (preferred)."
}
},
"additionalProperties": false
}