Resume Booster Job Board

Search the live job board (postings pulled directly from employers' own hiring systems, 30-day freshness cap; board_stats carries the live totals). Returns compact job cards — including the board's own parsed pay (salaryMinAnnual/salaryMaxAnnual/salaryPeriod), experience band and minYears, so pay and seniority never have to be re-read out of prose — plus the board's honesty disclosures: exact totals when knowable (countUnavailable otherwise), filters it could not honour (ignoredFilters), words it read as filters (intentFilters), and spelling suggestions. Set agentReadyOnly=true to see only jobs the apply agent can submit to directly.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search terms. Supports exclusions: 'engineer -senior'."
    },
    "location": {
      "type": "string",
      "description": "City/state/metro, e.g. 'texas', 'NYC', 'berlin'."
    },
    "country": {
      "type": "string",
      "description": "ISO-2 codes, comma-separated, max 5. E.g. 'US,GB'."
    },
    "remote": {
      "type": "boolean",
      "description": "Only remote-friendly roles."
    },
    "workMode": {
      "type": "string",
      "description": "Comma list of: remote, hybrid, onsite."
    },
    "employmentType": {
      "type": "string",
      "description": "Comma list of: full_time, part_time, contract, temporary, internship."
    },
    "category": {
      "type": "string",
      "description": "Comma list of category slugs (see board_stats for the live set), max 3."
    },
    "department": {
      "type": "string",
      "description": "Substring match on the employer's own department/team text."
    },
    "companies": {
      "type": "string",
      "description": "Scope to specific employers: a comma list of companyToken values from job cards (or from the site's employer pages). An employer the board does not carry simply matches nothing; tokens the board drops are named in ignoredFilters."
    },
    "experience": {
      "type": "string",
      "description": "Comma list of seniority bands the POSTING asks for: entry, mid, senior, expert. Rows whose band could not be read are excluded — use maxYears for the candidate's own side of the question."
    },
    "maxAgeDays": {
      "type": "number",
      "description": "Only postings from the last N days (1-30)."
    },
    "postedAfter": {
      "type": "string",
      "description": "ISO-8601 instant; only postings the EMPLOYER dated after it. Undated rows fall out of this window (unlike maxAgeDays, which falls back to when the board first saw a posting), so this is the strict form of 'new'."
    },
    "salaryMin": {
      "type": "number",
      "description": "Annual USD-equivalent salary floor. Note: only ~13% of postings state pay."
    },
    "salaryMax": {
      "type": "number",
      "description": "Annual USD-equivalent salary ceiling."
    },
    "includeUnstatedPay": {
      "type": "boolean",
      "description": "WIDENS an active salaryMin/salaryMax band to also admit postings that state no pay at all. Inert with no band set (unpriced rows are already included). The response says salaryStatedOnly when a band is narrowing without it."
    },
    "hasStatedPay": {
      "type": "boolean",
      "description": "Only postings whose pay field carries a figure the employer published — hourly and per-shift rates included, read from the `salary` field. About 28% of the board (2026-09-27). Narrower than it sounds only for RANKING: salaryFloor compares an annualised figure in approximate US dollars, which about 24% carry, so some rows this returns cannot be filtered by pay amount."
    },
    "payBasis": {
      "type": "string",
      "enum": [
        "hourly",
        "salaried"
      ],
      "description": "Restrict to hourly or salaried pay."
    },
    "maxYears": {
      "type": "number",
      "description": "Only roles asking for at most N years of experience."
    },
    "vendor": {
      "type": "string",
      "description": "Comma list of hiring-system vendors (greenhouse, lever, ashby, …), max 8. Not available here: usajobs — The U.S. federal job feed is readable on resumebooster.work but may not be redistributed as a data feed under its terms of use, so no tool here returns its rows. Naming one is refused rather than answered with an empty page."
    },
    "excludeAgencies": {
      "type": "boolean",
      "description": "Hide postings from staffing/recruiting agencies (their job cards carry agency:true). Agencies are served by default; this is an opt-in narrowing."
    },
    "agentReadyOnly": {
      "type": "boolean",
      "description": "Only jobs the apply agent can submit to on the user's behalf."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "newest",
        "salary"
      ],
      "description": "Default relevance."
    },
    "limit": {
      "type": "number",
      "description": "Rows per page, 1-60. Default 20."
    },
    "offset": {
      "type": "number",
      "description": "Paging offset — pass back the previous response's nextOffset."
    }
  }
}

{
  "type": "object",
  "properties": {
    "jobs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "vendor:employer:externalId — the id every other tool takes."
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "companyToken": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer handle; pass it back in search_jobs `companies`."
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO-2."
          },
          "workMode": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "remote",
              "hybrid",
              "onsite",
              null
            ],
            "description": "The employer's own statement: the option they chose in their ATS, or their own words on the posting (title, location, department). null has THREE meanings: neither source says anything, the two disagree and the board refuses to choose, or the posting is older than the vendor field this board now reads. Never inferred from the description, and silence is never read as onsite."
          },
          "employmentType": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "department": {
            "type": "string",
            "description": "The employer's own team name. ABSENT when the posting carries none."
          },
          "salary": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer's own pay text, verbatim and unparsed."
          },
          "salaryMinAnnual": {
            "type": "number",
            "description": "Annual USD-equivalent floor, parsed by the board. ABSENT when the posting states no pay — absence is not zero."
          },
          "salaryMaxAnnual": {
            "type": "number",
            "description": "Annual USD-equivalent ceiling. ABSENT when unstated."
          },
          "salaryPeriod": {
            "type": "string",
            "description": "The period the employer stated: hour, month, year. ABSENT when unstated (~89% of the board)."
          },
          "salaryCurrency": {
            "type": "string",
            "description": "ISO-4217, as stated. ABSENT when unstated."
          },
          "experienceBand": {
            "type": "string",
            "enum": [
              "entry",
              "mid",
              "senior",
              "expert"
            ],
            "description": "ABSENT when the posting's seniority could not be read."
          },
          "minYears": {
            "type": "integer",
            "description": "Years of experience the posting asks for. ABSENT when it names none (~71%)."
          },
          "postedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer's own date, ISO-8601. Null when the feed carries none — never the date we first saw it."
          },
          "applyUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "agentReady": {
            "type": "boolean",
            "description": "True when request_application can submit to this hiring system."
          },
          "agency": {
            "type": "boolean",
            "description": "Present and true when the posting comes from a staffing/recruiting agency."
          },
          "recheckedAt": {
            "type": "string",
            "description": "When the employer's feed was last fetched and still carried this employer's board."
          }
        },
        "required": [
          "id",
          "agentReady"
        ],
        "additionalProperties": true
      }
    },
    "total": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Exact match count. ABSENT with countUnavailable:true when the board refuses to guess."
    },
    "countUnavailable": {
      "type": "boolean",
      "description": "The board could not count this query exactly — do not report a total."
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextOffset": {
      "type": "integer",
      "description": "Pass back as `offset` for the next page."
    },
    "ignoredFilters": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filters the board could NOT apply. Results answer a wider question than was asked."
    },
    "excludedTerms": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "intentFilters": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Words read out of the query as filters."
    },
    "didYouMean": {
      "type": "string"
    },
    "salaryStatedOnly": {
      "type": "boolean",
      "description": "Row-selecting: this page excludes the ~76% of postings with no annualised figure in approximate US dollars (2026-09-27), including postings that publish an hourly rate."
    },
    "agenciesExcluded": {
      "type": "boolean",
      "description": "Row-selecting: disclosed agency inventory is hidden from this page."
    }
  },
  "required": [
    "jobs"
  ],
  "additionalProperties": true
}

Full detail for one job id (from search_jobs), including the complete description text and when the employer's feed last confirmed it open. A resumebooster.work/jobs?job=<id> link's id is this argument (and fetch's, check_apply_support's and request_application's). For several ids at once, use get_jobs — it costs ONE call against the daily quota instead of one per posting. Needs a key or a sign-in. With neither, call fetch with the same id.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The job id, e.g. 'greenhouse:acme:12345'."
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "vendor:employer:externalId — the id every other tool takes."
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "company": {
      "type": [
        "string",
        "null"
      ]
    },
    "companyToken": {
      "type": [
        "string",
        "null"
      ],
      "description": "The employer handle; pass it back in search_jobs `companies`."
    },
    "location": {
      "type": [
        "string",
        "null"
      ]
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO-2."
    },
    "workMode": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "remote",
        "hybrid",
        "onsite",
        null
      ],
      "description": "The employer's own statement: the option they chose in their ATS, or their own words on the posting (title, location, department). null has THREE meanings: neither source says anything, the two disagree and the board refuses to choose, or the posting is older than the vendor field this board now reads. Never inferred from the description, and silence is never read as onsite."
    },
    "employmentType": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "department": {
      "type": "string",
      "description": "The employer's own team name. ABSENT when the posting carries none."
    },
    "salary": {
      "type": [
        "string",
        "null"
      ],
      "description": "The employer's own pay text, verbatim and unparsed."
    },
    "salaryMinAnnual": {
      "type": "number",
      "description": "Annual USD-equivalent floor, parsed by the board. ABSENT when the posting states no pay — absence is not zero."
    },
    "salaryMaxAnnual": {
      "type": "number",
      "description": "Annual USD-equivalent ceiling. ABSENT when unstated."
    },
    "salaryPeriod": {
      "type": "string",
      "description": "The period the employer stated: hour, month, year. ABSENT when unstated (~89% of the board)."
    },
    "salaryCurrency": {
      "type": "string",
      "description": "ISO-4217, as stated. ABSENT when unstated."
    },
    "experienceBand": {
      "type": "string",
      "enum": [
        "entry",
        "mid",
        "senior",
        "expert"
      ],
      "description": "ABSENT when the posting's seniority could not be read."
    },
    "minYears": {
      "type": "integer",
      "description": "Years of experience the posting asks for. ABSENT when it names none (~71%)."
    },
    "postedAt": {
      "type": [
        "string",
        "null"
      ],
      "description": "The employer's own date, ISO-8601. Null when the feed carries none — never the date we first saw it."
    },
    "applyUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "agentReady": {
      "type": "boolean",
      "description": "True when request_application can submit to this hiring system."
    },
    "agency": {
      "type": "boolean",
      "description": "Present and true when the posting comes from a staffing/recruiting agency."
    },
    "recheckedAt": {
      "type": "string",
      "description": "When the employer's feed was last fetched and still carried this employer's board."
    },
    "description": {
      "type": "string",
      "description": "The posting's full text, truncated at 24,000 characters with a [truncated] marker."
    },
    "job": {
      "type": "null",
      "description": "Present and null when there is no posting to return; read `closed` / `agedOut` / `notFound` beside it."
    },
    "closed": {
      "type": "object",
      "additionalProperties": true,
      "description": "The board watched this posting come down: title, company, closedAt."
    },
    "agedOut": {
      "type": "object",
      "additionalProperties": true,
      "description": "Past the 30-day freshness cap."
    },
    "notFound": {
      "type": "boolean",
      "description": "No posting with this id — never on this board, or gone long enough that nothing is remembered."
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Full detail for up to 10 job ids in ONE call — the shortlist form of get_job. Each id answers with a card plus its description; ids that closed, aged out or were never on this board come back in `unavailable` with the reason named, so one dead id never costs you the other nine. Set includeDescription=false for cards and freshness only (much smaller, and no vendor fetch). Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "description": "Job ids from search_jobs. Up to 10 per call — each one is a separate detail read that may fetch the employer's page."
    },
    "includeDescription": {
      "type": "boolean",
      "description": "Default true. Descriptions are capped at 8,000 characters here; call get_job for the whole text of one."
    }
  },
  "required": [
    "ids"
  ]
}

{
  "type": "object",
  "properties": {
    "jobs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "vendor:employer:externalId — the id every other tool takes."
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "companyToken": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer handle; pass it back in search_jobs `companies`."
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO-2."
          },
          "workMode": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "remote",
              "hybrid",
              "onsite",
              null
            ],
            "description": "The employer's own statement: the option they chose in their ATS, or their own words on the posting (title, location, department). null has THREE meanings: neither source says anything, the two disagree and the board refuses to choose, or the posting is older than the vendor field this board now reads. Never inferred from the description, and silence is never read as onsite."
          },
          "employmentType": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "department": {
            "type": "string",
            "description": "The employer's own team name. ABSENT when the posting carries none."
          },
          "salary": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer's own pay text, verbatim and unparsed."
          },
          "salaryMinAnnual": {
            "type": "number",
            "description": "Annual USD-equivalent floor, parsed by the board. ABSENT when the posting states no pay — absence is not zero."
          },
          "salaryMaxAnnual": {
            "type": "number",
            "description": "Annual USD-equivalent ceiling. ABSENT when unstated."
          },
          "salaryPeriod": {
            "type": "string",
            "description": "The period the employer stated: hour, month, year. ABSENT when unstated (~89% of the board)."
          },
          "salaryCurrency": {
            "type": "string",
            "description": "ISO-4217, as stated. ABSENT when unstated."
          },
          "experienceBand": {
            "type": "string",
            "enum": [
              "entry",
              "mid",
              "senior",
              "expert"
            ],
            "description": "ABSENT when the posting's seniority could not be read."
          },
          "minYears": {
            "type": "integer",
            "description": "Years of experience the posting asks for. ABSENT when it names none (~71%)."
          },
          "postedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer's own date, ISO-8601. Null when the feed carries none — never the date we first saw it."
          },
          "applyUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "agentReady": {
            "type": "boolean",
            "description": "True when request_application can submit to this hiring system."
          },
          "agency": {
            "type": "boolean",
            "description": "Present and true when the posting comes from a staffing/recruiting agency."
          },
          "recheckedAt": {
            "type": "string",
            "description": "When the employer's feed was last fetched and still carried this employer's board."
          }
        },
        "required": [
          "id",
          "agentReady"
        ],
        "additionalProperties": true
      }
    },
    "unavailable": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "reason": {
            "type": "string",
            "enum": [
              "closed",
              "agedOut",
              "notFound",
              "error"
            ]
          },
          "closed": {
            "type": "object",
            "additionalProperties": true
          },
          "agedOut": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "id",
          "reason"
        ],
        "additionalProperties": true
      }
    },
    "requested": {
      "type": "integer"
    },
    "returned": {
      "type": "integer"
    },
    "notFetched": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ids past the per-call cap — sent, not read. Call again with these."
    }
  },
  "required": [
    "jobs",
    "unavailable"
  ],
  "additionalProperties": true
}

Are these postings still on the board? Answers up to 200 ids in one call — the tool for re-verifying a saved shortlist before acting on it, instead of spending a metered get_job per posting. Returns open:{id:boolean} plus the closed ids, and names the basis of the answer: it reads the board's index (a closed posting is one the employer's feed stopped listing), not the employer's site at this instant, and it is a weaker test than get_job's — read `basis` before reporting a posting as live to a person. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 200,
      "description": "Job ids from search_jobs. Up to 200 per call; anything past that is named in notChecked rather than silently dropped."
    }
  },
  "required": [
    "ids"
  ]
}

{
  "type": "object",
  "properties": {
    "open": {
      "type": "object",
      "additionalProperties": {
        "type": "boolean"
      },
      "description": "One entry per id checked."
    },
    "closed": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The ids that are no longer on the board."
    },
    "checked": {
      "type": "integer"
    },
    "openCount": {
      "type": "integer"
    },
    "closedCount": {
      "type": "integer"
    },
    "notChecked": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "basis": {
      "type": "string",
      "description": "What 'open' means in this answer."
    }
  },
  "required": [
    "open",
    "basis"
  ],
  "additionalProperties": true
}

Whether the apply agent can submit an application for this job on the user's behalf, and what that requires. Jobs on non-supported systems still return their direct applyUrl for the human to use. For whether THIS KEY may apply at all, call key_status — this tool answers about the job, not the key. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string"
    },
    "agentReady": {
      "type": "boolean",
      "description": "True when the posting's hiring system is one the apply agent can submit to."
    },
    "vendor": {
      "type": [
        "string",
        "null"
      ],
      "description": "The hiring-system prefix of the id, e.g. 'greenhouse'. Null when the id carries none."
    },
    "applyUrl": {
      "type": "string",
      "description": "The employer's own apply page. ABSENT when the board could not read the posting."
    },
    "requirements": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What applying through the agent needs — or, on a non-supported system, the one line saying the human applies at applyUrl."
    }
  },
  "required": [
    "jobId",
    "agentReady",
    "vendor",
    "requirements"
  ],
  "additionalProperties": true
}

Ask the board's apply agent to submit an application to this job on behalf of the key's owner. Needs an account key (mint one at https://resumebooster.work/agents), an active Agent plan OR a live Agent Pass (bought signed-in at https://resumebooster.work/agents/pass), and a mandate set in Account — call key_status first: it says which of the three is missing, and on a pass how many applications and how much time are left. Every application passes the same gates as the signed-in flow, including the honesty classifier: answers are drawn from the owner's own profile and never invented. Ask the person for a yes on this specific job id before calling. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "description": "The job id from search_jobs."
    },
    "note": {
      "type": "string",
      "description": "Optional note stored with the request (not sent to the employer)."
    }
  },
  "required": [
    "jobId"
  ]
}

{
  "type": "object",
  "properties": {
    "accepted": {
      "type": "boolean",
      "description": "False when a gate refused; true when the request is in the agent's queue (or already was)."
    },
    "refusedBy": {
      "type": "string",
      "description": "Refused only: the gate — key, jobId, mandate, resume, plan (no Agent plan and no live pass), pass (the pass has no applications left or its clock ended), posting, scope-country, scope-category, scope-age, scope-salary."
    },
    "error": {
      "type": "string",
      "description": "Refused only: what the gate said."
    },
    "fix": {
      "type": "string",
      "description": "Refused only: what would change the answer."
    },
    "alreadyQueued": {
      "type": "boolean",
      "description": "Accepted only: this job was already in the queue — nothing duplicated, and on a pass nothing spent."
    },
    "passApplicationsLeft": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Accepted on a pass: applications left on it after this one. Null when a subscription funded the request."
    },
    "queueStatus": {
      "type": "string",
      "description": "With alreadyQueued: the existing row's status."
    },
    "jobId": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "company": {
      "type": "string"
    },
    "fitPct": {
      "type": [
        "number",
        "null"
      ],
      "description": "Keyword fit of the résumé on file to this posting, 0-100; null when the posting has no text to score."
    },
    "warning": {
      "type": "string",
      "description": "Accepted but flagged: below the release floor, or a system the agent prepares for rather than submits to."
    },
    "whatHappensNext": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "accepted"
  ],
  "oneOf": [
    {
      "required": [
        "accepted",
        "refusedBy",
        "error",
        "fix"
      ]
    },
    {
      "required": [
        "accepted",
        "alreadyQueued"
      ]
    },
    {
      "required": [
        "accepted",
        "jobId",
        "fitPct",
        "whatHappensNext"
      ]
    }
  ],
  "additionalProperties": true
}

Status of applications the key owner's agent has requested — queued, submitted, refused (with the refusing gate named), or failed. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Most recent N, default 20, max 50."
    }
  }
}

{
  "type": "object",
  "properties": {
    "queued": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "postingId": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "postingId",
          "status"
        ],
        "additionalProperties": true
      },
      "description": "Requests waiting for the hourly preparer, newest first."
    },
    "applications": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "postingId": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "vendor": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "notReleasedBecause": {
            "type": "string",
            "description": "Present when release was refused: the gate, named."
          },
          "needsHumanFor": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Present when blocked: the kinds of answer the classifier would not invent."
          },
          "submittedAt": {
            "type": "string"
          },
          "submittedVia": {
            "type": "string"
          }
        },
        "required": [
          "postingId",
          "status"
        ],
        "additionalProperties": true
      },
      "description": "Prepared packets and their outcome, newest first."
    },
    "statusKey": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "What each status word means."
    },
    "error": {
      "type": "string",
      "description": "Only when this key is not linked to an account."
    },
    "fix": {
      "type": "string"
    }
  },
  "oneOf": [
    {
      "required": [
        "queued",
        "applications",
        "statusKey"
      ]
    },
    {
      "required": [
        "error",
        "fix"
      ]
    }
  ],
  "additionalProperties": true
}

Score a résumé against open jobs, for an agent holding a CV: reads the occupation out of resumeText (or uses `query` if given), searches the board for it, and scores up to 20 results 0-100 with the matched and missing terms per job. PAID — needs a paid API key, exactly like POST /v1/fit on the data API, or a live Agent Pass on the key's account; a free key gets an in-band refusal naming where to upgrade. A null fit means the posting has no stored description to score. Returns the terms it read from the CV so the agent can pick a different one and call again with `query`. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "The candidate's résumé as plain text (100+ characters)."
    },
    "query": {
      "type": "string",
      "description": "Optional job title to search instead of the one read from the résumé."
    },
    "location": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "remote": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "description": "Jobs to score, 1-20 (default 20)."
    }
  },
  "required": [
    "resumeText"
  ]
}

{
  "type": "object",
  "properties": {
    "terms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The occupations read out of the résumé, best first."
    },
    "query": {
      "type": [
        "string",
        "null"
      ],
      "description": "What was actually searched. Null when no occupation was recognised."
    },
    "jobs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "vendor:employer:externalId — the id every other tool takes."
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "companyToken": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer handle; pass it back in search_jobs `companies`."
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO-2."
          },
          "workMode": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "remote",
              "hybrid",
              "onsite",
              null
            ],
            "description": "The employer's own statement: the option they chose in their ATS, or their own words on the posting (title, location, department). null has THREE meanings: neither source says anything, the two disagree and the board refuses to choose, or the posting is older than the vendor field this board now reads. Never inferred from the description, and silence is never read as onsite."
          },
          "employmentType": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "department": {
            "type": "string",
            "description": "The employer's own team name. ABSENT when the posting carries none."
          },
          "salary": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer's own pay text, verbatim and unparsed."
          },
          "salaryMinAnnual": {
            "type": "number",
            "description": "Annual USD-equivalent floor, parsed by the board. ABSENT when the posting states no pay — absence is not zero."
          },
          "salaryMaxAnnual": {
            "type": "number",
            "description": "Annual USD-equivalent ceiling. ABSENT when unstated."
          },
          "salaryPeriod": {
            "type": "string",
            "description": "The period the employer stated: hour, month, year. ABSENT when unstated (~89% of the board)."
          },
          "salaryCurrency": {
            "type": "string",
            "description": "ISO-4217, as stated. ABSENT when unstated."
          },
          "experienceBand": {
            "type": "string",
            "enum": [
              "entry",
              "mid",
              "senior",
              "expert"
            ],
            "description": "ABSENT when the posting's seniority could not be read."
          },
          "minYears": {
            "type": "integer",
            "description": "Years of experience the posting asks for. ABSENT when it names none (~71%)."
          },
          "postedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "The employer's own date, ISO-8601. Null when the feed carries none — never the date we first saw it."
          },
          "applyUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "agentReady": {
            "type": "boolean",
            "description": "True when request_application can submit to this hiring system."
          },
          "agency": {
            "type": "boolean",
            "description": "Present and true when the posting comes from a staffing/recruiting agency."
          },
          "recheckedAt": {
            "type": "string",
            "description": "When the employer's feed was last fetched and still carried this employer's board."
          },
          "fit": {
            "type": [
              "number",
              "null"
            ],
            "description": "Keyword fit 0-100. NULL means the posting has no stored description to score — not a poor match."
          },
          "matched": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "missing": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "id",
          "agentReady"
        ],
        "additionalProperties": true
      }
    },
    "note": {
      "type": "string"
    },
    "total": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Exact match count. ABSENT with countUnavailable:true when the board refuses to guess."
    },
    "countUnavailable": {
      "type": "boolean",
      "description": "The board could not count this query exactly — do not report a total."
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextOffset": {
      "type": "integer",
      "description": "Pass back as `offset` for the next page."
    },
    "ignoredFilters": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filters the board could NOT apply. Results answer a wider question than was asked."
    },
    "excludedTerms": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "intentFilters": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Words read out of the query as filters."
    },
    "didYouMean": {
      "type": "string"
    },
    "salaryStatedOnly": {
      "type": "boolean",
      "description": "Row-selecting: this page excludes the ~76% of postings with no annualised figure in approximate US dollars (2026-09-27), including postings that publish an hourly rate."
    },
    "agenciesExcluded": {
      "type": "boolean",
      "description": "Row-selecting: disclosed agency inventory is hidden from this page."
    }
  },
  "required": [
    "terms",
    "jobs"
  ],
  "additionalProperties": true
}

Live board statistics from cache (cheap to call): servable and tracked posting totals, the count of company job boards with open roles (boards, not employers — one employer can run several), the category set, freshness stamp. Answers with no key too, with a withKey block saying what a free key adds.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "servablePostings": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Postings the board serves right now: not withdrawn, dated within the freshness window. Null when the pass did not compute it."
    },
    "trackedPostings": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Every posting the board holds, including ones outside the serving rules."
    },
    "openCompanyBoards": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Company job boards with at least one servable posting. BOARDS, not employers — read openCompanyBoardsBasis."
    },
    "openCompanyBoardsBasis": {
      "type": "string"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The category slugs search_jobs accepts."
    },
    "freshnessWindowDays": {
      "type": "integer"
    },
    "refreshedAt": {
      "type": [
        "string",
        "null"
      ],
      "description": "When the cache these figures come from was last written."
    },
    "note": {
      "type": "string"
    },
    "withKey": {
      "type": "object",
      "properties": {
        "mintUrl": {
          "type": "string"
        },
        "dailyCalls": {
          "type": "integer",
          "description": "Calls a day on a free key."
        },
        "adds": {
          "type": "string",
          "description": "What a free key opens beyond the unkeyed tools."
        }
      },
      "required": [
        "mintUrl",
        "dailyCalls",
        "adds"
      ],
      "description": "Present on an unkeyed call: where a free key comes from and what it adds."
    }
  },
  "required": [
    "servablePostings",
    "openCompanyBoards",
    "openCompanyBoardsBasis",
    "categories",
    "freshnessWindowDays"
  ],
  "additionalProperties": true
}

For each employer handle (companyToken, up to 20 per call), that employer's own record on this board: open_roles now, closed_90d (postings we watched come off this board in the last 90 days, re-lists excluded), superseded_90d (the re-lists, a floor), the two medians from the employer's own stated dates (lower bounds), tracking_days (how long we have watched THIS board, capped at 90) and feed_total (what its feed advertised at the last check). A takedown is not a hire — a filled role, a cancelled one and a withdrawn one look identical from here — and it is a record of one BOARD, never summed across an employer's boards, never a headcount. A board with no closure observed answers record:'unknown' with the reason, never a verdict about the employer: on a board bigger than one visit can read, no closure is observable to us until we complete a provable full pass and then watch a role go after it, so silence there is about our instrument. Every row carries its basis. Every row also carries layoff_filing — the newest layoff filing joined to that employer by a hand-curated alias or an exact multi-token name match, a US state WARN notice or an SEC 8-K Item 2.05 disclosure, printed as a filing (filer verbatim, its dates with their bases, count, state or form, link), read hourly from SEC EDGAR and nightly from state notices, null when none qualifies within 90 days, and no part of record or any verdict; layoff_basis on the response says what it is and is not. Pair with employer_growth for the other half of what the site calls "Actively hiring". Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "companyTokens": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 20,
      "description": "companyToken values from job cards or search_jobs (a vendor tenant, e.g. 'acme' or 'gici~wd5~Careers'). Up to 20; more is refused with the count named."
    }
  },
  "required": [
    "companyTokens"
  ]
}

{
  "type": "object",
  "properties": {
    "employers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "company_token": {
            "type": "string"
          },
          "record": {
            "type": "string",
            "enum": [
              "observed",
              "unknown"
            ],
            "description": "observed: the ledger holds at least one closure for this board in the window, so the figures speak. unknown: it holds none, with unknown_reason saying why that is not a finding."
          },
          "unknown_reason": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "no_record",
              "no_closures_observed",
              null
            ]
          },
          "open_roles": {
            "type": "integer",
            "description": "Postings served from this board right now, under the same two serving rules as search."
          },
          "closed_90d": {
            "type": "integer",
            "description": "Watched takedowns in the window, re-lists excluded. Never a count of hires."
          },
          "superseded_90d": {
            "type": "integer",
            "description": "Re-lists in the window — a FLOOR, one logged per title per day."
          },
          "median_days_open": {
            "type": [
              "number",
              "null"
            ],
            "description": "Median age of the roles served now, from the employer's stated dates only. Null when none carry one."
          },
          "median_days_to_close": {
            "type": [
              "number",
              "null"
            ],
            "description": "Median stated-date-to-takedown over the window's dated closures. A lower bound; null when no closure carries a date."
          },
          "tracking_days": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Days this board has been watched, capped."
          },
          "feed_total": {
            "type": [
              "integer",
              "null"
            ],
            "description": "What the employer's feed advertised at the last verification. Null when never verified."
          },
          "basis": {
            "type": "string"
          },
          "note": {
            "type": "string",
            "description": "Present on an unknown row: what the absence means and does not mean."
          },
          "layoff_filing": {
            "type": [
              "object",
              "null"
            ],
            "description": "The newest qualifying layoff filing joined to this employer, or null when none qualifies. A fact about the employer on one date, beside the record and no part of it.",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "sec_8k_205",
                  "state_warn"
                ],
                "description": "state_warn: a US state WARN notice. sec_8k_205: an SEC 8-K Item 2.05 disclosure."
              },
              "relation": {
                "type": "string",
                "enum": [
                  "filer",
                  "subsidiary_site"
                ],
                "description": "filer: the filer is this board's employer. subsidiary_site: the filer is the parent company of this board's employer."
              },
              "filer": {
                "type": "string",
                "description": "The employer as the source names it, verbatim — never the board's own display name."
              },
              "event_date": {
                "type": "string",
                "description": "The filing's own date: the WARN notice date or the 8-K report date. Named by event_basis."
              },
              "event_basis": {
                "type": "string"
              },
              "public_date": {
                "type": "string",
                "description": "When it became public: the SEC file date or the state's received/processed/posted stamp. Named by public_basis."
              },
              "public_basis": {
                "type": "string"
              },
              "state": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Two-letter state of a WARN notice; null on an SEC filing."
              },
              "site": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The notice's site as the state lists it; null when not stated or on an SEC filing."
              },
              "workers": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Positions the WARN notice states at that site. Null on an SEC filing — never zero."
              },
              "event_type": {
                "type": [
                  "string",
                  "null"
                ],
                "enum": [
                  "closure",
                  "layoff",
                  "relocation",
                  "unknown",
                  null
                ],
                "description": "What the WARN notice says it is, as the state classifies it; null on an SEC filing."
              },
              "effective_date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The date the WARN notice gives for the separations; null when it gives none or on an SEC filing."
              },
              "pct": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Workforce share the 8-K states, as parsed; null when it states none or on a WARN notice."
              },
              "headcount": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Positions the 8-K states, as parsed; null when it states none or on a WARN notice."
              },
              "form": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The SEC form (an amendment never appears); null on a WARN notice."
              },
              "source_url": {
                "type": "string",
                "description": "The filing itself, at the source."
              },
              "source_name": {
                "type": "string",
                "description": "SEC EDGAR, or the state agency as it names itself."
              },
              "read_at": {
                "type": "string",
                "description": "When we read it. Our stamp, never a date basis for the filing."
              },
              "more_n": {
                "type": "integer",
                "description": "Further qualifying filings for this employer beyond this newest one."
              }
            },
            "required": [
              "source",
              "relation",
              "filer",
              "event_date",
              "event_basis",
              "public_date",
              "public_basis",
              "state",
              "site",
              "workers",
              "event_type",
              "effective_date",
              "pct",
              "headcount",
              "form",
              "source_url",
              "source_name",
              "read_at",
              "more_n"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "company_token",
          "record",
          "basis",
          "layoff_filing"
        ],
        "additionalProperties": true
      },
      "description": "One row per token asked, in the order asked. A token the board does not carry still answers, as unknown."
    },
    "asked": {
      "type": "integer"
    },
    "window_days": {
      "type": "integer"
    },
    "basis": {
      "type": "string"
    },
    "layoff_basis": {
      "type": "string",
      "description": "What layoff_filing is and is not, beside every row's record."
    },
    "layoff_read": {
      "type": "string",
      "description": "\"ok\" when the filing reader answered for every employer; otherwise \"unread: <fault>\" and every layoff_filing on this response is null for that reason, never because nothing qualified. The record is unaffected either way."
    }
  },
  "required": [
    "employers",
    "basis",
    "layoff_basis",
    "layoff_read"
  ],
  "additionalProperties": true
}

Did this employer's board serve more roles than it did 7 days earlier? One row per companyToken (up to 20 per call), judged by the board itself from our own daily observation and passed through untouched: grew, no-growth, or unknown — and unknown ALWAYS carries unknown_reason (a feed bigger than one visit can read, a board too new or too small for a rate, a gap in our own series, a pool that was replaced rather than grown…): an unknown is a reading we could not take, never a no. The bars the verdict uses: at least 10 roles served at the window's start; then BOTH at least 4 more roles AND at least 25% more, on a board tracked for at least 21 days, with every read in the window whole. Per BOARD (a vendor tenant), never summed across an employer's boards; more roles served is roles opened net of roles that came down — not a headcount and not a hire. This tool never ranks employers, and no list of growing employers exists here or anywhere on the board. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "companyTokens": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 20,
      "description": "companyToken values from job cards or search_jobs. Up to 20; more is refused with the count named."
    }
  },
  "required": [
    "companyTokens"
  ]
}

{
  "type": "object",
  "properties": {
    "employers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "company_token": {
            "type": "string"
          },
          "verdict": {
            "type": "string",
            "enum": [
              "grew",
              "no-growth",
              "unknown"
            ],
            "description": "The board's own judgement, passed through untouched. unknown is NOT no-growth: it is a reading we could not take, and unknown_reason says why."
          },
          "unknown_reason": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "excluded",
              "series_stale",
              "no_series",
              "too_new",
              "series_gap",
              "too_small",
              "pool_replaced",
              "not_in_ledger",
              "windowed_read",
              "failed_read",
              "ledger_gap",
              null
            ],
            "description": "Null for grew and no-growth. Otherwise the gate that refused, in the migration's own words."
          },
          "window_days": {
            "type": "integer"
          },
          "baseline_day": {
            "type": [
              "string",
              "null"
            ],
            "description": "Our observation date at the window's start."
          },
          "baseline_served": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Roles served on this board on baseline_day."
          },
          "latest_day": {
            "type": [
              "string",
              "null"
            ],
            "description": "Our latest observation date."
          },
          "latest_served": {
            "type": [
              "integer",
              "null"
            ]
          },
          "net": {
            "type": [
              "integer",
              "null"
            ],
            "description": "latest_served minus baseline_served: roles opened net of roles that came down. Not a headcount."
          },
          "rate": {
            "type": [
              "number",
              "null"
            ],
            "description": "net over baseline_served. Null when the baseline is zero or unread."
          },
          "days_observed": {
            "type": "integer"
          },
          "days_expected": {
            "type": "integer"
          },
          "ledger_days_expected": {
            "type": "integer"
          },
          "board_days_ok": {
            "type": "integer",
            "description": "Days in the read-quality ledger whose read of this board was whole."
          },
          "board_days_bad": {
            "type": "integer"
          },
          "first_snapshot_day": {
            "type": [
              "string",
              "null"
            ]
          },
          "tenure_days": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Days between the board's first daily observation and the window's start."
          },
          "tenure_censored": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "True when the board is as old as the series itself, so its real tenure is longer than we can say."
          },
          "untracked_departures": {
            "type": [
              "integer",
              "null"
            ],
            "description": "OUR removals over the window — never counted as the employer shrinking."
          },
          "removed_departures": {
            "type": [
              "integer",
              "null"
            ]
          },
          "observed_arrivals": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "company_token",
          "verdict",
          "unknown_reason"
        ],
        "additionalProperties": true
      },
      "description": "One row per token asked, in the order asked. A token with no daily series answers unknown with its reason."
    },
    "asked": {
      "type": "integer"
    },
    "bars": {
      "type": "object",
      "properties": {
        "window_days": {
          "type": "integer"
        },
        "min_baseline_served": {
          "type": "integer"
        },
        "min_net_add": {
          "type": "integer"
        },
        "min_rate": {
          "type": "number"
        },
        "min_tenure_days": {
          "type": "integer"
        }
      },
      "required": [
        "window_days",
        "min_baseline_served",
        "min_net_add",
        "min_rate",
        "min_tenure_days"
      ],
      "description": "What the verdict measured against — for reading a row, never for re-judging one."
    },
    "basis": {
      "type": "string"
    }
  },
  "required": [
    "employers",
    "bars",
    "basis"
  ],
  "additionalProperties": true
}

What THIS key is and may do: tier, requests left this minute, calls left today (both including this call), whether fit_resume (and engine=ranked on the data API) answers on it, and whether the apply tools would — with any blocker named: account link, Agent plan or live pass, mandate, résumé on file. On an Agent Pass: when the clock ends and how many applications are left (a pass starts at the first call other than this one). Call it first in a keyed session, and after any 'quota' or 'rate' refusal. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "key": {
      "type": "object",
      "properties": {
        "tier": {
          "type": "string"
        },
        "paid": {
          "type": "boolean"
        },
        "accountLinked": {
          "type": "boolean",
          "description": "False for a plain data-API key; the apply tools need a key minted while signed in."
        },
        "id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The key's row id — not the key itself, which the server never holds."
        }
      },
      "required": [
        "tier",
        "paid",
        "accountLinked"
      ],
      "additionalProperties": true
    },
    "rate": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer"
        },
        "used": {
          "type": "integer"
        },
        "remaining": {
          "type": "integer"
        },
        "window": {
          "type": "string"
        },
        "resetsInSeconds": {
          "type": "integer"
        }
      },
      "required": [
        "limit",
        "remaining"
      ],
      "additionalProperties": true
    },
    "quota": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer"
        },
        "used": {
          "type": "integer"
        },
        "remaining": {
          "type": "integer"
        },
        "window": {
          "type": "string"
        },
        "resetsInSeconds": {
          "type": "integer"
        }
      },
      "required": [
        "limit",
        "remaining"
      ],
      "additionalProperties": true
    },
    "features": {
      "type": "object",
      "properties": {
        "fit_resume": {
          "type": "boolean",
          "description": "Paid tiers and a live pass, exactly as POST /v1/fit plus the pass."
        },
        "rankedEngine": {
          "type": "boolean",
          "description": "/v1/jobs?engine=ranked on the data API, same key. Paid tiers only — never the pass."
        },
        "request_application": {
          "type": "boolean",
          "description": "True only when every apply gate below already passes."
        }
      },
      "required": [
        "fit_resume",
        "rankedEngine",
        "request_application"
      ],
      "additionalProperties": true
    },
    "pass": {
      "type": "object",
      "description": "The account's pass, if any. Every figure is read off the pass row; nothing here is a constant.",
      "properties": {
        "state": {
          "type": "string",
          "enum": [
            "none",
            "unactivated",
            "live",
            "closed"
          ]
        },
        "endsAt": {
          "type": [
            "string",
            "null"
          ],
          "description": "When the clock ends. Null until the pass starts."
        },
        "endsInSeconds": {
          "type": [
            "integer",
            "null"
          ]
        },
        "applicationsLeft": {
          "type": [
            "integer",
            "null"
          ]
        },
        "applicationsTotal": {
          "type": [
            "integer",
            "null"
          ]
        },
        "startsOn": {
          "type": "string"
        },
        "buy": {
          "type": "string",
          "description": "Where a pass is bought, signed in."
        }
      },
      "required": [
        "state",
        "startsOn",
        "buy"
      ],
      "additionalProperties": true
    },
    "apply": {
      "type": "object",
      "properties": {
        "ready": {
          "type": "boolean"
        },
        "accountLinked": {
          "type": "boolean"
        },
        "planActive": {
          "type": "boolean",
          "description": "An active Agent plan OR a live pass — either funds a new request."
        },
        "subscribed": {
          "type": "boolean",
          "description": "An active Agent plan specifically."
        },
        "passLive": {
          "type": "boolean",
          "description": "A live pass with an application left, specifically."
        },
        "mandateActive": {
          "type": "boolean"
        },
        "resumeOnFile": {
          "type": "boolean"
        },
        "pausedUntil": {
          "type": "string"
        },
        "blockers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Empty when ready. Each entry is the refusal request_application would give."
        },
        "requirements": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "ready",
        "blockers"
      ],
      "additionalProperties": true
    },
    "counted": {
      "type": "string"
    },
    "docs": {
      "type": "string"
    }
  },
  "required": [
    "key",
    "rate",
    "quota",
    "features",
    "pass",
    "apply"
  ],
  "additionalProperties": true
}

Explain WHY a search returns what it does — the board's own decision trace merged with the run's outcome. Shows the parsed query (terms, exclusions, intent-lifts, alias expansions), which filters were applied vs IGNORED and why, the route and retriever chosen, the ranking regime (ranked/ring-merged/deep-page and the seam), plus the real run's route, timings, count basis and any fallback. Use this when a search returns surprising, empty, or mis-ranked results — it turns 'why?' into one call. Takes the SAME arguments as search_jobs. Needs a key or a sign-in.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search terms. Supports exclusions: 'engineer -senior'."
    },
    "location": {
      "type": "string",
      "description": "City/state/metro, e.g. 'texas', 'NYC', 'berlin'."
    },
    "country": {
      "type": "string",
      "description": "ISO-2 codes, comma-separated, max 5. E.g. 'US,GB'."
    },
    "remote": {
      "type": "boolean",
      "description": "Only remote-friendly roles."
    },
    "workMode": {
      "type": "string",
      "description": "Comma list of: remote, hybrid, onsite."
    },
    "employmentType": {
      "type": "string",
      "description": "Comma list of: full_time, part_time, contract, temporary, internship."
    },
    "category": {
      "type": "string",
      "description": "Comma list of category slugs (see board_stats for the live set), max 3."
    },
    "department": {
      "type": "string",
      "description": "Substring match on the employer's own department/team text."
    },
    "companies": {
      "type": "string",
      "description": "Scope to specific employers: a comma list of companyToken values from job cards (or from the site's employer pages). An employer the board does not carry simply matches nothing; tokens the board drops are named in ignoredFilters."
    },
    "experience": {
      "type": "string",
      "description": "Comma list of seniority bands the POSTING asks for: entry, mid, senior, expert. Rows whose band could not be read are excluded — use maxYears for the candidate's own side of the question."
    },
    "maxAgeDays": {
      "type": "number",
      "description": "Only postings from the last N days (1-30)."
    },
    "postedAfter": {
      "type": "string",
      "description": "ISO-8601 instant; only postings the EMPLOYER dated after it. Undated rows fall out of this window (unlike maxAgeDays, which falls back to when the board first saw a posting), so this is the strict form of 'new'."
    },
    "salaryMin": {
      "type": "number",
      "description": "Annual USD-equivalent salary floor. Note: only ~13% of postings state pay."
    },
    "salaryMax": {
      "type": "number",
      "description": "Annual USD-equivalent salary ceiling."
    },
    "includeUnstatedPay": {
      "type": "boolean",
      "description": "WIDENS an active salaryMin/salaryMax band to also admit postings that state no pay at all. Inert with no band set (unpriced rows are already included). The response says salaryStatedOnly when a band is narrowing without it."
    },
    "hasStatedPay": {
      "type": "boolean",
      "description": "Only postings whose pay field carries a figure the employer published — hourly and per-shift rates included, read from the `salary` field. About 28% of the board (2026-09-27). Narrower than it sounds only for RANKING: salaryFloor compares an annualised figure in approximate US dollars, which about 24% carry, so some rows this returns cannot be filtered by pay amount."
    },
    "payBasis": {
      "type": "string",
      "enum": [
        "hourly",
        "salaried"
      ],
      "description": "Restrict to hourly or salaried pay."
    },
    "maxYears": {
      "type": "number",
      "description": "Only roles asking for at most N years of experience."
    },
    "vendor": {
      "type": "string",
      "description": "Comma list of hiring-system vendors (greenhouse, lever, ashby, …), max 8. Not available here: usajobs — The U.S. federal job feed is readable on resumebooster.work but may not be redistributed as a data feed under its terms of use, so no tool here returns its rows. Naming one is refused rather than answered with an empty page."
    },
    "excludeAgencies": {
      "type": "boolean",
      "description": "Hide postings from staffing/recruiting agencies (their job cards carry agency:true). Agencies are served by default; this is an opt-in narrowing."
    },
    "agentReadyOnly": {
      "type": "boolean",
      "description": "Only jobs the apply agent can submit to on the user's behalf."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "newest",
        "salary"
      ],
      "description": "Default relevance."
    },
    "limit": {
      "type": "number",
      "description": "Rows per page, 1-60. Default 20."
    },
    "offset": {
      "type": "number",
      "description": "Paging offset — pass back the previous response's nextOffset."
    }
  }
}

{
  "type": "object",
  "properties": {
    "decision": {
      "type": "object",
      "additionalProperties": true,
      "description": "The board's own explain trace for this query: parsed terms, filters applied or ignored and why, route, retriever and ranking regime. Its keys are the board's and change as the board's decisions do."
    },
    "outcome": {
      "type": "object",
      "properties": {
        "rowsServed": {
          "type": "integer"
        },
        "topTitles": {
          "type": "array",
          "items": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": "The first five titles served, for a glance at ranking."
        },
        "total": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Exact match count. ABSENT with countUnavailable:true when the board refuses to guess."
        },
        "countUnavailable": {
          "type": "boolean",
          "description": "The board could not count this query exactly — do not report a total."
        },
        "hasMore": {
          "type": "boolean"
        },
        "nextOffset": {
          "type": "integer",
          "description": "Pass back as `offset` for the next page."
        },
        "ignoredFilters": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Filters the board could NOT apply. Results answer a wider question than was asked."
        },
        "excludedTerms": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "intentFilters": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Words read out of the query as filters."
        },
        "didYouMean": {
          "type": "string"
        },
        "salaryStatedOnly": {
          "type": "boolean",
          "description": "Row-selecting: this page excludes the ~76% of postings with no annualised figure in approximate US dollars (2026-09-27), including postings that publish an hourly rate."
        },
        "agenciesExcluded": {
          "type": "boolean",
          "description": "Row-selecting: disclosed agency inventory is hidden from this page."
        },
        "phaseMs": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": true,
          "description": "Per-phase timings when the board reports them."
        },
        "tookMs": {
          "type": [
            "number",
            "null"
          ]
        },
        "rankedFellBack": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "True when the ranked path failed and the run fell back."
        }
      },
      "required": [
        "rowsServed",
        "topTitles",
        "phaseMs",
        "tookMs",
        "rankedFellBack"
      ],
      "additionalProperties": true
    }
  },
  "required": [
    "decision",
    "outcome"
  ],
  "additionalProperties": true
}

An ALIAS of search_jobs in the fixed shape ChatGPT's deep-research and company-knowledge connectors call: one query string in, {results:[{id,title,url}]} out. Every result's id is the job id fetch and every other tool take; url is the employer's own apply page when the board holds one, else the posting's page on the site. Same board, same ranking, same limit as an unkeyed search_jobs (10 rows); the disclosures ride beside the results. Any other client should call search_jobs, which takes every filter.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text — title, skills, a place, exclusions with a leading minus."
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The job id — pass it to fetch, get_job, check_jobs_open."
          },
          "title": {
            "type": "string",
            "description": "Title and employer, one line."
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": true
      }
    },
    "note": {
      "type": "string"
    },
    "total": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Exact match count. ABSENT with countUnavailable:true when the board refuses to guess."
    },
    "countUnavailable": {
      "type": "boolean",
      "description": "The board could not count this query exactly — do not report a total."
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextOffset": {
      "type": "integer",
      "description": "Pass back as `offset` for the next page."
    },
    "ignoredFilters": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filters the board could NOT apply. Results answer a wider question than was asked."
    },
    "excludedTerms": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "intentFilters": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Words read out of the query as filters."
    },
    "didYouMean": {
      "type": "string"
    },
    "salaryStatedOnly": {
      "type": "boolean",
      "description": "Row-selecting: this page excludes the ~76% of postings with no annualised figure in approximate US dollars (2026-09-27), including postings that publish an hourly rate."
    },
    "agenciesExcluded": {
      "type": "boolean",
      "description": "Row-selecting: disclosed agency inventory is hidden from this page."
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": true
}

An ALIAS of get_job in the fixed shape ChatGPT's deep-research and company-knowledge connectors call: one id in (from search), {id,title,text,url,metadata} out. text is the posting's full description; metadata carries the job card's structured fields (pay, experience, location, workMode, postedAt, companyToken, agentReady). A dead id answers with what the board knows — a watched closure, an aged-out stub, or not found — in text and metadata, never a stale card. Any other client should call get_job.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A job id from search."
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Null when there is no posting to return; read metadata.closed / agedOut / notFound."
    },
    "text": {
      "type": "string",
      "description": "The description, or the board's one-line reason when there is none."
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true,
      "description": "The compact job card without the description; on a dead id, the board's closed/agedOut/notFound record."
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url",
    "metadata"
  ],
  "additionalProperties": true
}