jobs

Create Job Listing

Create a new job listing for tracking and ATS analysis. Idempotent per user on sourceUrl: when the caller already tracks the same posting (tracking params, trailing slash and fragment ignored), the existing listing is returned with 200 and nothing is inserted.

post/jobs

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/jobs
  • Auth: HTTP bearer

Request body

companystring

Company name

descriptionstring required

Full job description text

keywordsstring[]

ATS keywords

locationstring

Job location

requirementsstring[]

Job requirements

salarystring

Salary range or details

sourceUrlstring uri

URL where the job listing was found

titlestring required

Job title

Example request

{
  "company": "Acme Corp",
  "description": "We are looking for a senior engineer...",
  "keywords": [
    "react",
    "typescript",
    "aws"
  ],
  "location": "Remote, US",
  "requirements": [
    "5+ years experience",
    "Bachelor degree"
  ],
  "salary": "$120,000 - $160,000",
  "sourceUrl": "https://linkedin.com/jobs/123",
  "title": "Senior Software Engineer"
}

Response

The caller already tracks this posting; that listing is returned

successtrue required

Example response

{
  "data": {
    "jobMatchId": 42
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.