Resume Booster Job Board

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

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

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['servablePostings', 'openCompanyBoards', 'openCompanyBoardsBasis', 'categories', 'freshnessWindowDays'], 'properties': {'note': {'type': 'string'}, 'withKey': {'type': 'object', 'required': ['mintUrl', 'dailyCalls', 'adds'], 'properties': {'adds': {'type': 'string', 'description': 'What a free key opens beyond the unkeyed tools.'}, 'mintUrl': {'type': 'string'}, 'dailyCalls': {'type': 'integer', 'description': 'Calls a day on a free key.'}}, 'description': 'Present on an unkeyed call: where a free key comes from and what it adds.'}, 'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The category slugs search_jobs accepts.'}, 'refreshedAt': {'type': ['string', 'null'], 'description': 'When the cache these figures come from was last written.'}, 'trackedPostings': {'type': ['integer', 'null'], 'description': 'Every posting the board holds, including ones outside the serving rules.'}, '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.'}, 'openCompanyBoards': {'type': ['integer', 'null'], 'description': 'Company job boards with at least one servable posting. BOARDS, not employers — read openCompanyBoardsBasis.'}, 'freshnessWindowDays': {'type': 'integer'}, 'openCompanyBoardsBasis': {'type': 'string'}}, 'additionalProperties': True}

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

{'type': 'object', 'required': ['jobId', 'agentReady', 'vendor', 'requirements'], 'properties': {'jobId': {'type': 'string'}, '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."}, 'agentReady': {'type': 'boolean', 'description': "True when the posting's hiring system is one the apply agent can submit to."}, '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.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['ids'], '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.'}}}

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

{'type': 'object', 'properties': {'sort': {'enum': ['relevance', 'newest', 'salary'], 'type': 'string', 'description': 'Default relevance.'}, 'limit': {'type': 'number', 'description': 'Rows per page, 1-60. Default 20.'}, 'query': {'type': 'string', 'description': "Search terms. Supports exclusions: 'engineer -senior'."}, 'offset': {'type': 'number', 'description': "Paging offset — pass back the previous response's nextOffset."}, 'remote': {'type': 'boolean', 'description': 'Only remote-friendly roles.'}, '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.'}, 'country': {'type': 'string', 'description': "ISO-2 codes, comma-separated, max 5. E.g. 'US,GB'."}, 'category': {'type': 'string', 'description': 'Comma list of category slugs (see board_stats for the live set), max 3.'}, 'location': {'type': 'string', 'description': "City/state/metro, e.g. 'texas', 'NYC', 'berlin'."}, 'maxYears': {'type': 'number', 'description': 'Only roles asking for at most N years of experience.'}, 'payBasis': {'enum': ['hourly', 'salaried'], 'type': 'string', 'description': 'Restrict to hourly or salaried pay.'}, 'workMode': {'type': 'string', 'description': 'Comma list of: remote, hybrid, onsite.'}, '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."}, 'salaryMax': {'type': 'number', 'description': 'Annual USD-equivalent salary ceiling.'}, 'salaryMin': {'type': 'number', 'description': 'Annual USD-equivalent salary floor. Note: only ~13% of postings state pay.'}, 'department': {'type': 'string', 'description': "Substring match on the employer's own department/team text."}, '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'."}, '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.'}, 'agentReadyOnly': {'type': 'boolean', 'description': "Only jobs the apply agent can submit to on the user's behalf."}, 'employmentType': {'type': 'string', 'description': 'Comma list of: full_time, part_time, contract, temporary, internship.'}, '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.'}, '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.'}}}

{'type': 'object', 'required': ['decision', 'outcome'], 'properties': {'outcome': {'type': 'object', 'required': ['rowsServed', 'topTitles', 'phaseMs', 'tookMs', 'rankedFellBack'], 'properties': {'total': {'type': ['integer', 'null'], 'description': 'Exact match count. ABSENT with countUnavailable:true when the board refuses to guess.'}, 'tookMs': {'type': ['number', 'null']}, 'hasMore': {'type': 'boolean'}, 'phaseMs': {'type': ['object', 'null'], 'description': 'Per-phase timings when the board reports them.', 'additionalProperties': True}, 'topTitles': {'type': 'array', 'items': {'type': ['string', 'null']}, 'description': 'The first five titles served, for a glance at ranking.'}, 'didYouMean': {'type': 'string'}, 'nextOffset': {'type': 'integer', 'description': 'Pass back as `offset` for the next page.'}, 'rowsServed': {'type': 'integer'}, 'excludedTerms': {'type': 'array', 'items': {'type': 'string'}}, 'intentFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Words read out of the query as filters.'}, 'ignoredFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filters the board could NOT apply. Results answer a wider question than was asked.'}, 'rankedFellBack': {'type': ['boolean', 'null'], 'description': 'True when the ranked path failed and the run fell back.'}, 'agenciesExcluded': {'type': 'boolean', 'description': 'Row-selecting: disclosed agency inventory is hidden from this page.'}, 'countUnavailable': {'type': 'boolean', 'description': 'The board could not count this query exactly — do not report a total.'}, '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.'}}, 'additionalProperties': True}, 'decision': {'type': 'object', '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.", 'additionalProperties': True}}, 'additionalProperties': True}

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

{'type': 'object', 'required': ['employers', 'bars', 'basis'], 'properties': {'bars': {'type': 'object', 'required': ['window_days', 'min_baseline_served', 'min_net_add', 'min_rate', 'min_tenure_days'], 'properties': {'min_rate': {'type': 'number'}, 'min_net_add': {'type': 'integer'}, 'window_days': {'type': 'integer'}, 'min_tenure_days': {'type': 'integer'}, 'min_baseline_served': {'type': 'integer'}}, 'description': 'What the verdict measured against — for reading a row, never for re-judging one.'}, 'asked': {'type': 'integer'}, 'basis': {'type': 'string'}, 'employers': {'type': 'array', 'items': {'type': 'object', 'required': ['company_token', 'verdict', 'unknown_reason'], 'properties': {'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.'}, 'verdict': {'enum': ['grew', 'no-growth', 'unknown'], 'type': 'string', '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."}, 'latest_day': {'type': ['string', 'null'], 'description': 'Our latest observation date.'}, 'tenure_days': {'type': ['integer', 'null'], 'description': "Days between the board's first daily observation and the window's start."}, 'window_days': {'type': 'integer'}, 'baseline_day': {'type': ['string', 'null'], 'description': "Our observation date at the window's start."}, 'board_days_ok': {'type': 'integer', 'description': 'Days in the read-quality ledger whose read of this board was whole.'}, 'company_token': {'type': 'string'}, 'days_expected': {'type': 'integer'}, 'days_observed': {'type': 'integer'}, 'latest_served': {'type': ['integer', 'null']}, 'board_days_bad': {'type': 'integer'}, 'unknown_reason': {'enum': ['excluded', 'series_stale', 'no_series', 'too_new', 'series_gap', 'too_small', 'pool_replaced', 'not_in_ledger', 'windowed_read', 'failed_read', 'ledger_gap', None], 'type': ['string', 'null'], 'description': "Null for grew and no-growth. Otherwise the gate that refused, in the migration's own words."}, 'baseline_served': {'type': ['integer', 'null'], 'description': 'Roles served on this board on baseline_day.'}, '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.'}, 'observed_arrivals': {'type': ['integer', 'null']}, 'first_snapshot_day': {'type': ['string', 'null']}, 'removed_departures': {'type': ['integer', 'null']}, 'ledger_days_expected': {'type': 'integer'}, 'untracked_departures': {'type': ['integer', 'null'], 'description': 'OUR removals over the window — never counted as the employer shrinking.'}}, 'additionalProperties': True}, 'description': 'One row per token asked, in the order asked. A token with no daily series answers unknown with its reason.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['companyTokens'], 'properties': {'companyTokens': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'minItems': 1, '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."}}}

{'type': 'object', 'required': ['employers', 'basis', 'layoff_basis', 'layoff_read'], 'properties': {'asked': {'type': 'integer'}, 'basis': {'type': 'string'}, 'employers': {'type': 'array', 'items': {'type': 'object', 'required': ['company_token', 'record', 'basis', 'layoff_filing'], 'properties': {'note': {'type': 'string', 'description': 'Present on an unknown row: what the absence means and does not mean.'}, 'basis': {'type': 'string'}, 'record': {'enum': ['observed', 'unknown'], 'type': 'string', '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.'}, 'closed_90d': {'type': 'integer', 'description': 'Watched takedowns in the window, re-lists excluded. Never a count of hires.'}, 'feed_total': {'type': ['integer', 'null'], 'description': "What the employer's feed advertised at the last verification. Null when never verified."}, 'open_roles': {'type': 'integer', 'description': 'Postings served from this board right now, under the same two serving rules as search.'}, 'company_token': {'type': 'string'}, 'layoff_filing': {'type': ['object', 'null'], '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'], 'properties': {'pct': {'type': ['number', 'null'], 'description': 'Workforce share 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.'}, 'site': {'type': ['string', 'null'], 'description': "The notice's site as the state lists it; null when not stated or on an SEC filing."}, 'filer': {'type': 'string', 'description': "The employer as the source names it, verbatim — never the board's own display name."}, 'state': {'type': ['string', 'null'], 'description': 'Two-letter state of a WARN notice; null on an SEC filing.'}, 'more_n': {'type': 'integer', 'description': 'Further qualifying filings for this employer beyond this newest one.'}, 'source': {'enum': ['sec_8k_205', 'state_warn'], 'type': 'string', 'description': 'state_warn: a US state WARN notice. sec_8k_205: an SEC 8-K Item 2.05 disclosure.'}, 'read_at': {'type': 'string', 'description': 'When we read it. Our stamp, never a date basis for the filing.'}, 'workers': {'type': ['integer', 'null'], 'description': 'Positions the WARN notice states at that site. Null on an SEC filing — never zero.'}, 'relation': {'enum': ['filer', 'subsidiary_site'], 'type': 'string', 'description': "filer: the filer is this board's employer. subsidiary_site: the filer is the parent company of this board's employer."}, 'headcount': {'type': ['integer', 'null'], 'description': 'Positions the 8-K states, as parsed; null when it states none or on a WARN notice.'}, '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_type': {'enum': ['closure', 'layoff', 'relocation', 'unknown', None], 'type': ['string', 'null'], 'description': 'What the WARN notice says it is, as the state classifies it; null on an SEC filing.'}, 'source_url': {'type': 'string', 'description': 'The filing itself, at the source.'}, '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."}, 'source_name': {'type': 'string', 'description': 'SEC EDGAR, or the state agency as it names itself.'}, 'public_basis': {'type': 'string'}, '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.'}}, '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.', 'additionalProperties': False}, 'tracking_days': {'type': ['integer', 'null'], 'description': 'Days this board has been watched, capped.'}, 'superseded_90d': {'type': 'integer', 'description': 'Re-lists in the window — a FLOOR, one logged per title per day.'}, 'unknown_reason': {'enum': ['no_record', 'no_closures_observed', None], 'type': ['string', 'null']}, '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."}}, 'additionalProperties': True}, 'description': 'One row per token asked, in the order asked. A token the board does not carry still answers, as unknown.'}, '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.'}, 'window_days': {'type': 'integer'}, 'layoff_basis': {'type': 'string', 'description': "What layoff_filing is and is not, beside every row's record."}}, 'additionalProperties': True}

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

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

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

{'type': 'object', 'required': ['terms', 'jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'agentReady'], 'properties': {'id': {'type': 'string', 'description': 'vendor:employer:externalId — the id every other tool takes.'}, 'fit': {'type': ['number', 'null'], 'description': 'Keyword fit 0-100. NULL means the posting has no stored description to score — not a poor match.'}, 'title': {'type': ['string', 'null']}, 'agency': {'type': 'boolean', 'description': 'Present and true when the posting comes from a staffing/recruiting agency.'}, 'salary': {'type': ['string', 'null'], 'description': "The employer's own pay text, verbatim and unparsed."}, 'company': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null'], 'description': 'ISO-2.'}, 'matched': {'type': 'array', 'items': {'type': 'string'}}, 'missing': {'type': 'array', 'items': {'type': 'string'}}, 'applyUrl': {'type': ['string', 'null']}, 'category': {'type': ['string', 'null']}, 'location': {'type': ['string', 'null']}, '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."}, 'workMode': {'enum': ['remote', 'hybrid', 'onsite', None], 'type': ['string', '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."}, 'agentReady': {'type': 'boolean', 'description': 'True when request_application can submit to this hiring system.'}, 'department': {'type': 'string', 'description': "The employer's own team name. ABSENT when the posting carries none."}, 'recheckedAt': {'type': 'string', 'description': "When the employer's feed was last fetched and still carried this employer's board."}, 'companyToken': {'type': ['string', 'null'], 'description': 'The employer handle; pass it back in search_jobs `companies`.'}, 'salaryPeriod': {'type': 'string', 'description': 'The period the employer stated: hour, month, year. ABSENT when unstated (~89% of the board).'}, 'employmentType': {'type': ['string', 'null']}, 'experienceBand': {'enum': ['entry', 'mid', 'senior', 'expert'], 'type': 'string', 'description': "ABSENT when the posting's seniority could not be read."}, 'salaryCurrency': {'type': 'string', 'description': 'ISO-4217, as stated. ABSENT when unstated.'}, 'salaryMaxAnnual': {'type': 'number', 'description': 'Annual USD-equivalent ceiling. ABSENT when unstated.'}, 'salaryMinAnnual': {'type': 'number', 'description': 'Annual USD-equivalent floor, parsed by the board. ABSENT when the posting states no pay — absence is not zero.'}}, 'additionalProperties': True}}, 'note': {'type': 'string'}, 'query': {'type': ['string', 'null'], 'description': 'What was actually searched. Null when no occupation was recognised.'}, 'terms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The occupations read out of the résumé, best first.'}, 'total': {'type': ['integer', 'null'], 'description': 'Exact match count. ABSENT with countUnavailable:true when the board refuses to guess.'}, 'hasMore': {'type': 'boolean'}, 'didYouMean': {'type': 'string'}, 'nextOffset': {'type': 'integer', 'description': 'Pass back as `offset` for the next page.'}, 'excludedTerms': {'type': 'array', 'items': {'type': 'string'}}, 'intentFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Words read out of the query as filters.'}, 'ignoredFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filters the board could NOT apply. Results answer a wider question than was asked.'}, 'agenciesExcluded': {'type': 'boolean', 'description': 'Row-selecting: disclosed agency inventory is hidden from this page.'}, 'countUnavailable': {'type': 'boolean', 'description': 'The board could not count this query exactly — do not report a total.'}, '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.'}}, 'additionalProperties': True}

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

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

{'type': 'object', 'required': ['ids'], '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.'}}}

{'type': 'object', 'required': ['jobs', 'unavailable'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'agentReady'], 'properties': {'id': {'type': 'string', 'description': 'vendor:employer:externalId — the id every other tool takes.'}, 'title': {'type': ['string', 'null']}, 'agency': {'type': 'boolean', 'description': 'Present and true when the posting comes from a staffing/recruiting agency.'}, 'salary': {'type': ['string', 'null'], 'description': "The employer's own pay text, verbatim and unparsed."}, 'company': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null'], 'description': 'ISO-2.'}, 'applyUrl': {'type': ['string', 'null']}, 'category': {'type': ['string', 'null']}, 'location': {'type': ['string', 'null']}, '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."}, 'workMode': {'enum': ['remote', 'hybrid', 'onsite', None], 'type': ['string', '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."}, 'agentReady': {'type': 'boolean', 'description': 'True when request_application can submit to this hiring system.'}, 'department': {'type': 'string', 'description': "The employer's own team name. ABSENT when the posting carries none."}, 'recheckedAt': {'type': 'string', 'description': "When the employer's feed was last fetched and still carried this employer's board."}, 'companyToken': {'type': ['string', 'null'], 'description': 'The employer handle; pass it back in search_jobs `companies`.'}, 'salaryPeriod': {'type': 'string', 'description': 'The period the employer stated: hour, month, year. ABSENT when unstated (~89% of the board).'}, 'employmentType': {'type': ['string', 'null']}, 'experienceBand': {'enum': ['entry', 'mid', 'senior', 'expert'], 'type': 'string', 'description': "ABSENT when the posting's seniority could not be read."}, 'salaryCurrency': {'type': 'string', 'description': 'ISO-4217, as stated. ABSENT when unstated.'}, 'salaryMaxAnnual': {'type': 'number', 'description': 'Annual USD-equivalent ceiling. ABSENT when unstated.'}, 'salaryMinAnnual': {'type': 'number', 'description': 'Annual USD-equivalent floor, parsed by the board. ABSENT when the posting states no pay — absence is not zero.'}}, 'additionalProperties': True}}, 'returned': {'type': 'integer'}, 'requested': {'type': 'integer'}, 'notFetched': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Ids past the per-call cap — sent, not read. Call again with these.'}, 'unavailable': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'reason'], 'properties': {'id': {'type': 'string'}, 'closed': {'type': 'object', 'additionalProperties': True}, 'reason': {'enum': ['closed', 'agedOut', 'notFound', 'error'], 'type': 'string'}, 'agedOut': {'type': 'object', 'additionalProperties': True}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['key', 'rate', 'quota', 'features', 'pass', 'apply'], 'properties': {'key': {'type': 'object', 'required': ['tier', 'paid', 'accountLinked'], 'properties': {'id': {'type': ['string', 'null'], 'description': "The key's row id — not the key itself, which the server never holds."}, 'paid': {'type': 'boolean'}, 'tier': {'type': 'string'}, 'accountLinked': {'type': 'boolean', 'description': 'False for a plain data-API key; the apply tools need a key minted while signed in.'}}, 'additionalProperties': True}, 'docs': {'type': 'string'}, 'pass': {'type': 'object', 'required': ['state', 'startsOn', 'buy'], 'properties': {'buy': {'type': 'string', 'description': 'Where a pass is bought, signed in.'}, 'state': {'enum': ['none', 'unactivated', 'live', 'closed'], 'type': 'string'}, 'endsAt': {'type': ['string', 'null'], 'description': 'When the clock ends. Null until the pass starts.'}, 'startsOn': {'type': 'string'}, 'endsInSeconds': {'type': ['integer', 'null']}, 'applicationsLeft': {'type': ['integer', 'null']}, 'applicationsTotal': {'type': ['integer', 'null']}}, 'description': "The account's pass, if any. Every figure is read off the pass row; nothing here is a constant.", 'additionalProperties': True}, 'rate': {'type': 'object', 'required': ['limit', 'remaining'], 'properties': {'used': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'window': {'type': 'string'}, 'remaining': {'type': 'integer'}, 'resetsInSeconds': {'type': 'integer'}}, 'additionalProperties': True}, 'apply': {'type': 'object', 'required': ['ready', 'blockers'], 'properties': {'note': {'type': 'string'}, 'ready': {'type': 'boolean'}, 'blockers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Empty when ready. Each entry is the refusal request_application would give.'}, 'passLive': {'type': 'boolean', 'description': 'A live pass with an application left, specifically.'}, '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.'}, 'pausedUntil': {'type': 'string'}, 'requirements': {'type': 'array', 'items': {'type': 'string'}}, 'resumeOnFile': {'type': 'boolean'}, 'accountLinked': {'type': 'boolean'}, 'mandateActive': {'type': 'boolean'}}, 'additionalProperties': True}, 'quota': {'type': 'object', 'required': ['limit', 'remaining'], 'properties': {'used': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'window': {'type': 'string'}, 'remaining': {'type': 'integer'}, 'resetsInSeconds': {'type': 'integer'}}, 'additionalProperties': True}, 'counted': {'type': 'string'}, 'features': {'type': 'object', 'required': ['fit_resume', 'rankedEngine', 'request_application'], '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.'}}, 'additionalProperties': True}}, 'additionalProperties': True}

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

{'type': 'object', 'oneOf': [{'required': ['accepted', 'refusedBy', 'error', 'fix']}, {'required': ['accepted', 'alreadyQueued']}, {'required': ['accepted', 'jobId', 'fitPct', 'whatHappensNext']}], 'required': ['accepted'], 'properties': {'fix': {'type': 'string', 'description': 'Refused only: what would change the answer.'}, 'note': {'type': 'string'}, 'error': {'type': 'string', 'description': 'Refused only: what the gate said.'}, 'jobId': {'type': 'string'}, 'title': {'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.'}, 'company': {'type': 'string'}, 'warning': {'type': 'string', 'description': 'Accepted but flagged: below the release floor, or a system the agent prepares for rather than submits to.'}, '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.'}, 'queueStatus': {'type': 'string', 'description': "With alreadyQueued: the existing row's status."}, 'alreadyQueued': {'type': 'boolean', 'description': 'Accepted only: this job was already in the queue — nothing duplicated, and on a pass nothing spent.'}, 'whatHappensNext': {'type': 'string'}, 'passApplicationsLeft': {'type': ['integer', 'null'], 'description': 'Accepted on a pass: applications left on it after this one. Null when a subscription funded the request.'}}, 'additionalProperties': True}

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

{'type': 'object', 'required': ['results'], 'properties': {'note': {'type': 'string'}, 'total': {'type': ['integer', 'null'], 'description': 'Exact match count. ABSENT with countUnavailable:true when the board refuses to guess.'}, 'hasMore': {'type': 'boolean'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string', 'description': 'The job id — pass it to fetch, get_job, check_jobs_open.'}, 'url': {'type': 'string'}, 'title': {'type': 'string', 'description': 'Title and employer, one line.'}}, 'additionalProperties': True}}, 'didYouMean': {'type': 'string'}, 'nextOffset': {'type': 'integer', 'description': 'Pass back as `offset` for the next page.'}, 'excludedTerms': {'type': 'array', 'items': {'type': 'string'}}, 'intentFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Words read out of the query as filters.'}, 'ignoredFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filters the board could NOT apply. Results answer a wider question than was asked.'}, 'agenciesExcluded': {'type': 'boolean', 'description': 'Row-selecting: disclosed agency inventory is hidden from this page.'}, 'countUnavailable': {'type': 'boolean', 'description': 'The board could not count this query exactly — do not report a total.'}, '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.'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'sort': {'enum': ['relevance', 'newest', 'salary'], 'type': 'string', 'description': 'Default relevance.'}, 'limit': {'type': 'number', 'description': 'Rows per page, 1-60. Default 20.'}, 'query': {'type': 'string', 'description': "Search terms. Supports exclusions: 'engineer -senior'."}, 'offset': {'type': 'number', 'description': "Paging offset — pass back the previous response's nextOffset."}, 'remote': {'type': 'boolean', 'description': 'Only remote-friendly roles.'}, '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.'}, 'country': {'type': 'string', 'description': "ISO-2 codes, comma-separated, max 5. E.g. 'US,GB'."}, 'category': {'type': 'string', 'description': 'Comma list of category slugs (see board_stats for the live set), max 3.'}, 'location': {'type': 'string', 'description': "City/state/metro, e.g. 'texas', 'NYC', 'berlin'."}, 'maxYears': {'type': 'number', 'description': 'Only roles asking for at most N years of experience.'}, 'payBasis': {'enum': ['hourly', 'salaried'], 'type': 'string', 'description': 'Restrict to hourly or salaried pay.'}, 'workMode': {'type': 'string', 'description': 'Comma list of: remote, hybrid, onsite.'}, '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."}, 'salaryMax': {'type': 'number', 'description': 'Annual USD-equivalent salary ceiling.'}, 'salaryMin': {'type': 'number', 'description': 'Annual USD-equivalent salary floor. Note: only ~13% of postings state pay.'}, 'department': {'type': 'string', 'description': "Substring match on the employer's own department/team text."}, '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'."}, '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.'}, 'agentReadyOnly': {'type': 'boolean', 'description': "Only jobs the apply agent can submit to on the user's behalf."}, 'employmentType': {'type': 'string', 'description': 'Comma list of: full_time, part_time, contract, temporary, internship.'}, '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.'}, '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.'}}}

{'type': 'object', 'required': ['jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'agentReady'], 'properties': {'id': {'type': 'string', 'description': 'vendor:employer:externalId — the id every other tool takes.'}, 'title': {'type': ['string', 'null']}, 'agency': {'type': 'boolean', 'description': 'Present and true when the posting comes from a staffing/recruiting agency.'}, 'salary': {'type': ['string', 'null'], 'description': "The employer's own pay text, verbatim and unparsed."}, 'company': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null'], 'description': 'ISO-2.'}, 'applyUrl': {'type': ['string', 'null']}, 'category': {'type': ['string', 'null']}, 'location': {'type': ['string', 'null']}, '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."}, 'workMode': {'enum': ['remote', 'hybrid', 'onsite', None], 'type': ['string', '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."}, 'agentReady': {'type': 'boolean', 'description': 'True when request_application can submit to this hiring system.'}, 'department': {'type': 'string', 'description': "The employer's own team name. ABSENT when the posting carries none."}, 'recheckedAt': {'type': 'string', 'description': "When the employer's feed was last fetched and still carried this employer's board."}, 'companyToken': {'type': ['string', 'null'], 'description': 'The employer handle; pass it back in search_jobs `companies`.'}, 'salaryPeriod': {'type': 'string', 'description': 'The period the employer stated: hour, month, year. ABSENT when unstated (~89% of the board).'}, 'employmentType': {'type': ['string', 'null']}, 'experienceBand': {'enum': ['entry', 'mid', 'senior', 'expert'], 'type': 'string', 'description': "ABSENT when the posting's seniority could not be read."}, 'salaryCurrency': {'type': 'string', 'description': 'ISO-4217, as stated. ABSENT when unstated.'}, 'salaryMaxAnnual': {'type': 'number', 'description': 'Annual USD-equivalent ceiling. ABSENT when unstated.'}, 'salaryMinAnnual': {'type': 'number', 'description': 'Annual USD-equivalent floor, parsed by the board. ABSENT when the posting states no pay — absence is not zero.'}}, 'additionalProperties': True}}, 'total': {'type': ['integer', 'null'], 'description': 'Exact match count. ABSENT with countUnavailable:true when the board refuses to guess.'}, 'hasMore': {'type': 'boolean'}, 'didYouMean': {'type': 'string'}, 'nextOffset': {'type': 'integer', 'description': 'Pass back as `offset` for the next page.'}, 'excludedTerms': {'type': 'array', 'items': {'type': 'string'}}, 'intentFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Words read out of the query as filters.'}, 'ignoredFilters': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filters the board could NOT apply. Results answer a wider question than was asked.'}, 'agenciesExcluded': {'type': 'boolean', 'description': 'Row-selecting: disclosed agency inventory is hidden from this page.'}, 'countUnavailable': {'type': 'boolean', 'description': 'The board could not count this query exactly — do not report a total.'}, '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.'}}, 'additionalProperties': True}