curl --request POST \
--url https://api.gospott.com/candidates/_from-unsupervised-cv/_bulk \
--header 'Content-Type: multipart/form-data' \
--header 'x-api-key: <api-key>' \
--form files=candidate_cv.pdf \
--form files.items='@example-file'123{
"status": 0,
"message": "<string>",
"requestId": "<string>",
"statusCode": 400,
"error": "Bad Request"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "Payload too large",
"requestId": "<string>",
"statusCode": 413,
"error": "Payload Too Large"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}Candidates
Bulk create candidates from CV
Automatically create multiple candidates from uploaded CV files without human review.
Process:
- Upload 1-20 CV files (PDF or DOCX format)
- AI automatically extracts candidate information
- Failed CV parsing is silently skipped
- Returns the count of successfully created candidates
Supported Formats:
- PDF (.pdf)
- Microsoft Word (.docx)
Limitations:
- Maximum 20 files per request
- Maximum 10MB per file
- Duplicate candidates (by email/phone/LinkedIn) trigger an automatic CV diff instead of creating duplicates
POST
/
candidates
/
_from-unsupervised-cv
/
_bulk
curl --request POST \
--url https://api.gospott.com/candidates/_from-unsupervised-cv/_bulk \
--header 'Content-Type: multipart/form-data' \
--header 'x-api-key: <api-key>' \
--form files=candidate_cv.pdf \
--form files.items='@example-file'123{
"status": 0,
"message": "<string>",
"requestId": "<string>",
"statusCode": 400,
"error": "Bad Request"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "Payload too large",
"requestId": "<string>",
"statusCode": 413,
"error": "Payload Too Large"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}Authorizations
API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.
Body
multipart/form-data
Upload 1-20 CV files to create candidates
Array of CV files (PDF or DOCX)
Required array length:
1 - 20 elementsCV file (max 10MB)
Response
CVs processed successfully. Returns the number of candidates created.
The response is of type number.
Was this page helpful?