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'

Candidates

Create candidates from CVs in bulk

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'

Authorizations

x-api-key

string

header

required

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

files

file[]

required

Array of CV files (PDF or DOCX)

Required array length: 1 - 20 elements

CV file (max 10MB)

Response

CVs processed successfully. Returns the number of candidates created.

Number of successfully created candidates (may be less than uploaded files if some fail)

Example:

3

Create candidate from CV Create a new client

⌘I

API Reference

Authorizations

Body

Response