KOkombo
AI Apply

Bulk import job postings

Changed on

Bulk import job postings into a job feed using NDJSON (newline-delimited JSON) format.

Request Format: Send one JSON object per line. Each line represents a job posting to import.

Example Request Body:

{"url":"https://careers.acme.com/job/1","career_site_label":"ACME Corp"}
{"url":"https://careers.acme.com/job/2","career_site_label":"ACME Corp","job_code":"ENG-123"}
{"url":"https://careers.acme.com/job/3","career_site_label":"ACME Corp","location":{"country":"US","postal_code":"94115"}}

Behavior:

  • Career sites are automatically created based on unique career_site_label values
  • Job postings are identified by the combination of URL + career_site_label + job_code
  • Existing job postings are updated; new ones are created and queued for parsing
  • Job postings from previous imports that are not included in the current import are archived

Constraints:

  • Maximum request size: 35 MB
  • Timeout: 5 minutes
  • One concurrent import per job feed
post/ai-apply/job-feeds/{job_feed_id}/bulk-import

Request

Path parameters

job_feed_idstring required

The ID of the job feed to import into

Request body application/x-ndjson

string required

NDJSON stream - each line is a JSON object representing a job posting

Response

Import completed successfully

status'success' required

Example response

{
  "status": "success",
  "data": {
    "created": 150,
    "processed": 197,
    "archived": 10
  }
}

Changes