Parse Job

Creates a new job by parsing raw job description text. You may optionally include metadata such as URL: or JobID: in the body. The response includes a structured Job object.

Sample Request & Response

POST

/v1/jobs

Sample Request

Headers:

{
  "Authorization": "Bearer <YOUR_API_KEY>",
  "Content-Type": "text/plain"
}

Body:

"Senior Backend Engineer\n\nWe're hiring a backend engineer with 5+ years of experience in Node.js, PostgreSQL, and system design.\n\nLocation: Remote\nSalary: $130k-150k\n\nURL: https://example.com/jobs/789\nJobID: backend_senior_001"

Sample Response (201)

{
  "id": "example_string",
  "createdAt": "2025-07-26T12:00:00Z",
  "updatedAt": "2025-07-26T12:00:00Z",
  "organizationId": "example_string",
  "memberId": "example_string",
  "locationId": "example_string",
  "rawText": "example_string",
  "parseStatus": "example_string",
  "title": "example_string",
  "postedAt": "2025-07-26T12:00:00Z",
  "jobUrl": "example_string",
  "jobId": "example_string",
  "applicationDeadline": "example_string",
  "applicationInstructions": "example_string",
  "industry": "example_string",
  "tags": [],
  "languageRequirements": [],
  "company": {
    "name": "example_string",
    "about": "example_string"
  },
  "location": [
    {
      "country": "example_string",
      "region": "example_string",
      "city": "example_string",
      "fullAddress": "example_string"
    }
  ],
  "employmentType": [
    "Full Time",
    "Part Time",
    "Contract",
    "Internship"
  ],
  "experienceLevel": [
    "Entry Level",
    "Mid Level",
    "Mid-Senior Level",
    "Senior Level",
    "Executive"
  ],
  "educationLevel": [
    [
      "Bachelors",
      "Masters",
      "Doctorate"
    ]
  ],
  "salaryRange": {
    "currencyCode": "example_string",
    "currencySymbol": "example_string",
    "text": "example_string",
    "low": 123,
    "high": 123
  },
  "remoteWorkOption": [
    "Onsite",
    "Hybrid",
    "Remote Anywhere (Global)",
    "Remote Nationwide (Country)",
    "Remote Regional/State"
  ],
  "description": "example_string",
  "requirements": [],
  "responsibilities": [],
  "benefits": [],
  "department": [],
  "skills": [],
  "mustHaveSkills": [],
  "minimumRequirements": [],
  "niceToHaveSkills": [],
  "preferredQualifications": []
}