Skip to main content
POST
/
ai-apply
/
postings
Parse a job posting
curl --request POST \
  --url https://api.kombo.dev/v1/ai-apply/postings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "career_site_id": "Chc4dua5asAQ48KUERDVF1bs",
  "url": "https://careers.acme.com/jobs/fullstack-engineer-ai-infra-14102",
  "job_code": "ACME_13",
  "location": {
    "country": "US",
    "postal_code": "94115"
  }
}'
{
  "status": "success",
  "data": {
    "id": "9QGNv3B98kL3hyELE1qsZ86s",
    "career_site": {
      "id": "Chc4dua5asAQ48KUERDVF1bs",
      "label": "Acme"
    },
    "url": "https://careers.acme.com/jobs/fullstack-engineer-ai-infra-14102",
    "job_code": "ACME_13",
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-03-02T23:12:32.000Z",
    "archived_at": null,
    "archived_reason": null,
    "availability": "PENDING"
  }
}

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Body

application/json

POST /ai-apply/postings Request body

​
career_site_id
string
required

The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.

​
url
string<uri>
required

The URL of the job posting to parse

​
job_code
string

Job code to associate with the job posting

​
location
object

The location in which the job is located

Response

POST /ai-apply/postings Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Examples:
{
  "id": "9QGNv3B98kL3hyELE1qsZ86s",
  "career_site": {
    "id": "Chc4dua5asAQ48KUERDVF1bs",
    "label": "Acme"
  },
  "url": "https://careers.acme.com/jobs/fullstack-engineer-ai-infra-14102",
  "job_code": "ACME_13",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-03-02T23:12:32.000Z",
  "archived_at": null,
  "archived_reason": null,
  "availability": "PENDING"
}