Real Job Check API

Send a job posting, get an evidence-cited verdict as JSON.

The API runs the same check our site runs. You send a posting as text or a link, and you get back a risk level, a 0 to 100 trust score, and the cited signals behind the score, each with the evidence and a source link. Pilots start with no integration at all: send us a sample and we send back a report. The API is for when you want it in your own posting flow.

Getting a key

Keys are issued by hand during a pilot. Tell us about your volume through the contact form and we will send a key and your free-pilot allowance. Treat the key like a password. It is sent once and cannot be shown again.

Authentication

Send your key as a bearer token on every request:

Authorization: Bearer rjc_live_your_key_here

Check a posting

POST https://api.realjobcheck.com/v1/check

Send JSON with the posting text, a link, or both:

curl https://api.realjobcheck.com/v1/check \
  -H "Authorization: Bearer rjc_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text":"Work from home data entry. Pay is $700 a week. Message us on Telegram to start. A $200 equipment deposit is required."}'

The response

You get the verdict and your usage:

{
  "verdict": {
    "level": "high_risk",
    "trust_score": 4,
    "headline": "HIGH RISK",
    "summary": "This posting shows several strong scam signals.",
    "signals": [
      {
        "signal_id": "upfront_payment",
        "title": "Asks you to pay to get hired",
        "severity": "fail",
        "summary": "A real employer never asks you to pay a deposit for equipment.",
        "weight": 45,
        "hard": true,
        "category": "content",
        "evidence": [
          { "detail": "Requests a $200 equipment deposit before you start.", "data": "$200 equipment deposit", "source_url": null }
        ]
      },
      {
        "signal_id": "off_platform",
        "title": "Pushes you to a chat app",
        "severity": "fail",
        "summary": "Scam hiring moves to Telegram or WhatsApp to avoid a paper trail.",
        "weight": 25,
        "hard": false,
        "category": "content",
        "evidence": [
          { "detail": "Tells you to message on Telegram to start.", "data": "Telegram", "source_url": null }
        ]
      }
    ],
    "next_steps": [
      "Do not send any money or a deposit.",
      "Report it to the FTC at reportfraud.ftc.gov."
    ],
    "report_targets": [
      { "name": "FTC", "url": "https://reportfraud.ftc.gov/", "note": "Report fraud and scams." }
    ],
    "disclaimer": "Informational risk assessment, not legal or financial advice.",
    "is_preliminary": false,
    "analysis": "The combination of an upfront deposit and a move to Telegram is a common advance-fee job scam pattern.",
    "apply_url": null,
    "apply_label": null
  },
  "usage": { "used": 7, "limit": 500, "remaining": 493, "mode": "full" }
}

The level is one of likely_legit, caution, or high_risk. A posting that looks real may also carry an apply_url, the company's own posting, so you can route applicants to the real source. A full verdict usually returns in about twenty seconds.

Limits and errors

• Each pilot key includes 500 free scans. Past that, the API returns 429 with pilot_limit_reached until the key is upgraded.
• There is a per-minute rate limit; going over returns 429 with rate_limited.
• A missing or invalid key returns 401 with invalid_key. An empty body returns 400 with no_input.

How we treat the data

Postings are processed in the moment: we scan them, return the verdict, and do not store the text or sell it. Only anonymous counts feed our public Job Scam Tracker. We score postings, never companies.

Start a pilot

A pilot needs no integration to begin. Send a note through the contact form with your rough monthly volume and we will reply by email, usually within a couple of business days.

Start a pilot