Headcount Labs

Count matching jobs without listing them. This is the live count; prefer it over market_lookup and market_breakdown for "how many" and "which employers are hiring". Counting by q also needs a title or company filter. Counting by description alone returns an estimate: count_is_estimate is true and count_margin gives the 95% range. To answer "which companies are hiring for X" or "how are these jobs split by ...", pass group_by: employer (company works too), work_arrangement (remote, hybrid or in_person), title, state (US), city, country or employment_type. The answer then also has group_by, groups (the top 25 values by number of matching jobs, each with value and jobs), groups_from_jobs (how many matching jobs were grouped, at most 1,000, taken in the default list order), groups_sampled (true when more jobs matched than were grouped, so the counts are from a sample) and groups_unknown_jobs (grouped jobs with no known value). A job with several locations or postings can count under more than one value. group_by employer keeps its own keys: employers (each with employer_name, company_id and jobs), employers_from_jobs, employers_sampled and employers_unknown_jobs. When a filter is too broad to count exactly in time, count is an estimate: the answer then has count_is_estimate: true, count_margin (the 95% range either side of count) and count_note.

Get a job by job_id. Default shape matches search_jobs, plus the full description, currentness, stale, last_checked_at, and linked postings. Pass view: "full" for every REST field, or fields to pick top-level properties (job_id is always included).

Find search_jobs filters and job fields matching keywords, with type and a short description. Pass words such as ["pay", "remote"]; no keywords lists everything. kind is filter or field (postings[].x is a posting property). A field state object says whether the source published the value (known), Atlas derived it, the source omitted it, or extraction failed.

Rank one dimension (by: title, state, city, company, seniority, employment_type or remote) by jobs, pay or another figure, optionally inside a filter. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.

List dimensions and metrics for market_lookup, market_breakdown and salary_range; pass dimension (and optional q) to list that dimension's values. No account needed.

Look up job count, pay, pay share, work arrangement, posting age, new postings or top employers for up to two of title, place, company, seniority, employment_type and remote. Omit metric for every figure. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.

Posted pay percentiles (25/50/75/90) for a title, place (default US) and optional seniority, with sample size and a short recommendation. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.

Search Headcount Labs docs (filters, limits, MCP setup, errors) and return matching sections with URLs. Works without an account.

Search current job postings by keyword, title, company, place, pay and date. Call list_fields for filter names. Country and employment_type accept comma-separated values or arrays. Pages return up to 50 jobs (limit, default 10), or 10 when descriptions is "full". Pass next_cursor as cursor for the next page. One search shows up to 250 jobs; narrow filters or use count_jobs for how many match. sort is relevance or updated. Default results are compact summaries (employer, title, locations, pay, dates, urls, snippet). Pass view: "full", fields, or get_job for more. descriptions: "snippet" (default) previews text; "full" returns whole descriptions. title matches a phrase in order; title_advanced matches words with AND, OR and NOT.