Skip to main content
POST
/
jobs
Create
curl --request POST \
  --url https://api.mapademics.com/v1/jobs \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "employerId": "<string>",
  "name": "Software Engineer",
  "description": "<string>",
  "jobDescriptionHref": "<string>",
  "locations": [
    {
      "type": "location",
      "locationId": "new-york-ny"
    }
  ],
  "salaryMin": 123,
  "salaryMax": 123,
  "onetSocCode": "<string>"
}'
{
  "id": "<string>",
  "organizationId": "<string>",
  "employerId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "jobDescriptionHref": "<string>",
  "locations": [
    {
      "type": "location",
      "locationId": "new-york-ny"
    }
  ],
  "salaryMin": 123,
  "salaryMax": 123,
  "onetSocCode": "<string>",
  "skills": [
    {
      "skillId": "<string>",
      "skillName": "<string>",
      "level": 3,
      "confidence": 0.5
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z"
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

extractSkills
boolean
default:false

Whether to automatically trigger skills extraction

Body

application/json
name
string
required

Job title

Example:

"Software Engineer"

employerId
string | null

Employer ID

description
string | null

Job description text

jobDescriptionHref
string<uri> | null

URL to job description document

locations
object[]

Job locations

salaryMin
integer | null

Minimum salary

salaryMax
integer | null

Maximum salary

onetSocCode
string | null

O*NET SOC occupation code

Response

Job created successfully

id
string
required
organizationId
string
required
name
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
employerId
string | null
description
string | null
jobDescriptionHref
string<uri> | null
locations
object[]
salaryMin
integer | null
salaryMax
integer | null
onetSocCode
string | null
skills
object[]

Extracted skills from job description

deletedAt
string<date-time> | null