VeritaHire live jobs

Search US jobs that are live right now on employers' own careers sites (re-read on a schedule, retired within about 36 hours of leaving). Give what (title or keywords) and where (City, ST or ZIP), or remote_only. Returns up to 25 jobs with posted pay, what each posting asks for (education, licences, years), distance, when it was last confirmed, the employer's own apply link, and a job_id for the whole posting. Only the filters given are applied; the "asks" are listed, never used to drop a job.

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "Job title or keywords, e.g. \"registered nurse\", \"forklift\""
    },
    "where": {
      "type": "string",
      "description": "\"City, ST\" or a 5-digit ZIP"
    },
    "radius_miles": {
      "type": "integer",
      "enum": [
        10,
        25,
        30,
        50,
        100
      ],
      "default": 25
    },
    "min_pay": {
      "type": "number",
      "description": "Minimum pay: annual, or hourly if under 300. Jobs that do not post pay are kept, listed last."
    },
    "employment_type": {
      "type": "string",
      "enum": [
        "full_time",
        "part_time",
        "contract",
        "seasonal",
        "temporary"
      ]
    },
    "remote_only": {
      "type": "boolean"
    },
    "posted_within_days": {
      "type": "integer",
      "enum": [
        1,
        3,
        7
      ]
    }
  }
}

The whole posting text from the employer, its requirement facts (education, licences, years required and preferred, skills), pay, benefits, whether it is still open, and the apply link.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "integer",
      "description": "VeritaHire job id, as returned in search results"
    },
    "url": {
      "type": "string"
    }
  }
}

Sends one email to the person's own address. Their click starts a daily email of new jobs matching this search (still live on employers' own careers sites) and creates their free VeritaHire account if needed. Nothing more is sent unless they click.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The person's own email address"
    },
    "what": {
      "type": "string"
    },
    "where": {
      "type": "string",
      "description": "\"City, ST\" or ZIP"
    },
    "radius_miles": {
      "type": "integer",
      "enum": [
        10,
        25,
        30,
        50,
        100
      ]
    },
    "employment_type": {
      "type": "string",
      "enum": [
        "full_time",
        "part_time",
        "contract",
        "seasonal",
        "temporary"
      ]
    },
    "remote_only": {
      "type": "boolean"
    }
  },
  "required": [
    "email"
  ]
}

Records a problem with VeritaHire data: a job listed as open that the employer's site shows closed (job_closed), wrong place, wrong pay, wrong employer name, a search that returned irrelevant results or missed jobs it should have found, or duplicates. job_id identifies one job; search holds the search arguments for a results problem. Reports are about data, not people, and a person at VeritaHire reads every one.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "job_closed",
        "wrong_location",
        "wrong_pay",
        "wrong_employer",
        "irrelevant_results",
        "missing_jobs",
        "duplicate",
        "other"
      ]
    },
    "job_id": {
      "type": "integer"
    },
    "detail": {
      "type": "string",
      "description": "What was wrong, in a sentence or two"
    },
    "search": {
      "type": "object",
      "description": "The search arguments that produced the problem"
    }
  },
  "required": [
    "kind"
  ]
}

Free salary / compensation benchmarking for one US healthcare clinical job posting (nurses, therapists, techs, pharmacists, aides): the pay competitors post for the same role nearby, how long roles like it take to close (time to fill), how long this employer's own roles usually take, who else is hiring for it within 25 miles, and recent closes. Measured from employers' own careers sites. Identify the posting by job_url (the careers-site link, or a veritahire.com/j/ link), job_id, or employer + title (+ city, state). A role not yet benchmarked returns status "building" with retry_after_seconds, the time until it is ready.

{
  "type": "object",
  "properties": {
    "job_url": {
      "type": "string",
      "description": "The posting's URL on the employer's careers site, or a veritahire.com/j/ URL"
    },
    "job_id": {
      "type": "integer",
      "description": "VeritaHire job id"
    },
    "employer": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "description": "Two-letter US state"
    }
  }
}

Emails the full benchmark report for a posting to the person who will use it (their work email). Their click creates a free VeritaHire account and opens the report. Nothing more is sent unless they click.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address the report goes to"
    },
    "job_url": {
      "type": "string"
    },
    "job_id": {
      "type": "integer"
    },
    "employer": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string"
    }
  },
  "required": [
    "email"
  ]
}

Checks whether a job posting is still on the employer's own careers site (VeritaHire re-reads employer sites and marks a posting closed within about 36 hours of it leaving). Returns open, closed or unknown, with the last time it was confirmed. Works for postings found anywhere, given the employer's careers-site link.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The posting URL (careers site or veritahire.com/j/)"
    },
    "job_id": {
      "type": "integer"
    }
  }
}