Previous value: -"One ATS, such as greenhouse or workday."New value: +"One ATS, such as greenhouse."

Previous value: -"A job category. A label or close name ('AI/ML') is read as its id."New value: +"A job category."

Previous value: -"Any company name containing this text, or a Board key such as 'ashby:openai' (needed beside `category`, or an exact name)."New value: +"Text in a company's name, or a Board key ('ashby:openai'); a key or exact name with `category`."

Previous value: -"An ISO 3166-1 alpha-2 code (US, GB, DE, IN) or a country's English name ('Germany', 'UK'). IN is india_place 'india'."New value: +"ISO code (US, GB) or English name ('Germany')."

Previous value: -"full adds counts per filter option and per country; slower."New value: +"full adds counts per filter and country (slow)."

Previous value: -"full-time also keeps jobs stating no type; the others keep only jobs that say so."New value: +"full-time also keeps jobs stating none."

Previous value: -"Leaves out every company whose name contains this text."New value: +"Skips companies whose name has this."

Previous value: -"New to HeadStart within this many hours."New value: +"First seen within this many hours."

Previous value: -"Only jobs that state a salary."New value: +"Only jobs stating a salary."

Previous value: -"Also keep jobs confidently not tech (a cashier), for a non-tech role the user wants."New value: +"Also keep jobs confidently not tech."

Previous value: -"An Indian city or region, such as 'bengaluru', 'delhi ncr' or 'pune', or 'india' for anywhere in India."New value: +"An Indian city or region ('pune'), or 'india'."

Previous value: -"Words the job must contain, each starting a word ('ai' finds AIOps, not Retail); double quotes keep a phrase together."New value: +"Words the job must contain, as word starts; quotes keep a phrase."

Previous value: -"Where `keyword` must appear; title unless sent."New value: +"Where `keyword` must be (title)."

Previous value: -"Text the job's location contains, any country; Zurich finds Zürich, Bangalore finds Bengaluru."New value: +"Text in the location; Zurich finds Zürich."

Previous value: -"Leaves out postings older than this many days; 0 for any age."New value: +"Skips postings older than this; 0: any age."

Previous value: -"The user's own years ('3+ years' is 3); jobs stating none are kept."New value: +"The user's years ('3+' is 3); keeps jobs stating none."

Previous value: -"Who may post the jobs; staffing (agencies) and aggregator (job boards) are left out unless named or a `company` is."New value: +"Who may post; staffing and aggregator need naming or `company`."

Previous value: -"Most rows of one company before others' (3; 0 for none)."New value: +"Most rows a company (3; 0: no cap)."

Previous value: -"Posted by the employer within this many days."New value: +"Posted within this many days."

Previous value: -"The role only; omit for the newest jobs."New value: +"The role only; omit for the newest."

Previous value: -"Jobs asking at least this many years; not the user's own."New value: +"Jobs asking at least this many years."

Previous value: -"ISO 4217 code, such as USD, INR, EUR."New value: +"ISO 4217, such as USD or INR."

Previous value: -"Annual, in salary_currency: keeps a stated range starting at or below it."New value: +"Annual; keeps ranges starting at or under it."

Previous value: -"Annual, in salary_currency (30 lakh = 3000000 INR): keeps a stated range reaching it."New value: +"Annual (30 lakh = 3000000); keeps ranges reaching it."

Previous value: -"A job id: rank by that job, leaving it out. Not with `query`."New value: +"A job id to rank by, not with `query`."

Previous value: -"With `query`, orders only matches scoring at least 0.67 among its 2,000 closest; salary by a range's low end."New value: +"With `query`, orders its 2,000 closest scoring 0.67+."

Previous value: -"What the description says of visas or relocation: an unhedged offer of sponsorship; also hedged or transfer-only offers (rows say which); a refusal or a citizenship requirement; relocation help. Read from the text by HeadStart's rules, so read the job with get_job before telling a user it sponsors."New value: +"As the description says, by HeadStart's rules; confirm with get_job."

Added value: +false

Added value: +false

Added value: +[
+  "id",
+  "title",
+  "company",
+  "key",
+  "url",
+  "location",
+  "remote",
+  "posted",
+  "first_seen",
+  "min_years",
+  "salary_min",
+  "salary_max",
+  "salary_currency",
+  "source",
+  "score"
+]

Previous value: -"A job category, across the whole index or, with `company`, within that company's jobs. A label or close name ('AI/ML') is read as its id."New value: +"A job category. A label or close name ('AI/ML') is read as its id."

Previous value: -"A company name, matched as the site's company box matches (any company name containing the text), or a Board key from an earlier answer such as 'ashby:openai'. In search_jobs beside `category` it needs a directory company: a key such as 'greenhouse:stripe', or an exact name."New value: +"Any company name containing this text, or a Board key such as 'ashby:openai' (needed beside `category`, or an exact name)."

Previous value: -"ISO 3166-1 alpha-2 code (US, GB, DE, IN); a country's name or 'UK', 'USA', 'UAE' is read as its code. Matches every way a job's location names the country: its name, states, cities and codes. IN is india_place 'india'."New value: +"An ISO 3166-1 alpha-2 code (US, GB, DE, IN) or a country's English name ('Germany', 'UK'). IN is india_place 'india'."

Removed value: -[
-  "US",
-  "IN",
-  "GB",
-  "CA",
-  "SG",
-  "DE",
-  "CN",
-  "AU",
-  "PL",
-  "MY",
-  "PH",
-  "ES",
-  "MX",
-  "NL",
-  "IE",
-  "AE",
-  "TW",
-  "JP",
-  "PT",
-  "RO",
-  "BR",
-  "EG",
-  "SA",
-  "FR",
-  "IL",
-  "VN",
-  "ZA",
-  "BE",
-  "IT",
-  "CH",
-  "SE",
-  "TH",
-  "GR",
-  "CO",
-  "HK",
-  "AR",
-  "PK",
-  "HU",
-  "BG",
-  "ID",
-  "NZ",
-  "NG",
-  "UA",
-  "QA",
-  "RS",
-  "DK",
-  "CZ",
-  "AT",
-  "CR",
-  "KR",
-  "LT",
-  "FI",
-  "NO",
-  "TR",
-  "LK",
-  "CL",
-  "PE",
-  "LB",
-  "LU",
-  "KE",
-  "CY",
-  "SK",
-  "MT",
-  "JO",
-  "PR",
-  "UY",
-  "EE",
-  "LV",
-  "HR",
-  "PA",
-  "AM",
-  "TN",
-  "DO",
-  "GE",
-  "SI",
-  "GT",
-  "KZ",
-  "BO",
-  "EC",
-  "SV",
-  "OM",
-  "MA",
-  "NI",
-  "AL",
-  "KW",
-  "BH",
-  "MD",
-  "MU",
-  "GH",
-  "BD",
-  "HN",
-  "PY",
-  "BA",
-  "MK",
-  "TZ",
-  "GY",
-  "SR",
-  "IQ",
-  "DZ",
-  "XK",
-  "NP",
-  "ZM",
-  "UG",
-  "BZ",
-  "KH",
-  "IS",
-  "BY",
-  "RW",
-  "ZW",
-  "UZ",
-  "KY",
-  "MV",
-  "CI",
-  "LY",
-  "SY",
-  "MM",
-  "MG",
-  "ET",
-  "CM",
-  "BS",
-  "TO",
-  "BN",
-  "PG",
-  "TT",
-  "LI",
-  "JM",
-  "PS",
-  "AZ"
-]

Added value: +60

Previous value: -"full adds the count behind each filter's options, and where every matching job is: the jobs in each country (what `country` would total, a job naming two in both) with its top cities, over the whole match."New value: +"full adds counts per filter option and per country; slower."

Previous value: -"full-time also keeps jobs whose source states no type; part-time, contract and internship keep only jobs that say so."New value: +"full-time also keeps jobs stating no type; the others keep only jobs that say so."

Previous value: -"Leaves out every job whose company name contains this text, such as the employer of a `similar_to` job."New value: +"Leaves out every company whose name contains this text."

Previous value: -"Also list the jobs HeadStart's classifier is confident are not tech (a store cashier, a plant's process engineer), which are left out unless this is true, as the site leaves them out unless its 'Include non-tech roles' switch is on. The answer says how many were left out. Send it for a role the user really wants that is not software or tech."New value: +"Also keep jobs confidently not tech (a cashier), for a non-tech role the user wants."

Previous value: -"An Indian city or region, or 'india' for anywhere in India."New value: +"An Indian city or region, such as 'bengaluru', 'delhi ncr' or 'pune', or 'india' for anywhere in India."

Removed value: -[
-  "india",
-  "delhi ncr",
-  "bengaluru",
-  "hyderabad",
-  "pune",
-  "chennai",
-  "mumbai",
-  "gurgaon",
-  "noida",
-  "kolkata",
-  "delhi",
-  "ahmedabad",
-  "coimbatore",
-  "vadodara",
-  "indore",
-  "chandigarh",
-  "thane",
-  "jaipur",
-  "kochi",
-  "bhubaneswar",
-  "thiruvananthapuram",
-  "surat",
-  "faridabad",
-  "nagpur",
-  "visakhapatnam",
-  "vijayawada",
-  "mysuru",
-  "nashik",
-  "goa",
-  "ghaziabad",
-  "anand",
-  "jajpur",
-  "meerut",
-  "savli",
-  "guntur",
-  "jammu",
-  "madurai",
-  "bhopal",
-  "jamshedpur",
-  "hosur",
-  "bharuch",
-  "shahjahanpur",
-  "lucknow",
-  "sikkim",
-  "tiruchirappalli",
-  "gandhinagar",
-  "halol",
-  "palghar",
-  "aurangabad",
-  "jalandhar",
-  "vellore",
-  "rajkot",
-  "mangaluru",
-  "kozhikode",
-  "jodhpur",
-  "patna",
-  "ludhiana",
-  "raipur",
-  "anakapalli",
-  "belagavi",
-  "puducherry",
-  "kanpur",
-  "ranchi",
-  "dehradun",
-  "amritsar",
-  "tirupati",
-  "udaipur",
-  "guwahati",
-  "srinagar",
-  "baddi"
-]

Added value: +40

Previous value: -"Words the job must contain, each at the start of a word: 'ai' finds AI and AIOps but not Retail, 'java' also finds JavaScript. Put a phrase in double quotes to keep its words together, in order: '\"ai engineer\"'. In descriptions it can match only jobs with a stored description, and the answer says how many have one. Not for visas or relocation: see `work_authorization`."New value: +"Words the job must contain, each starting a word ('ai' finds AIOps, not Retail); double quotes keep a phrase together."

Previous value: -"Where keyword must appear; title by default."New value: +"Where `keyword` must appear; title unless sent."

Added value: +"Jobs per page."

Previous value: -"Text the job's location contains, any country. Accents and a city's other spellings read alike: Zurich finds Zürich, Bangalore finds Bengaluru."New value: +"Text the job's location contains, any country; Zurich finds Zürich, Bangalore finds Bengaluru."

Previous value: -"Leaves out postings older than this many days: the posted date, else the day HeadStart first saw the job. 365 unless sent; 0 for any age."New value: +"Leaves out postings older than this many days; 0 for any age."

Previous value: -"The user's own years of experience ('3+ years' is 3): keeps jobs asking for at most this many, and jobs that state no experience (their rows say 'experience not stated')."New value: +"The user's own years ('3+ years' is 3); jobs stating none are kept."

Previous value: -"Who may post the jobs, as hiring_now labels companies: employer, services (an IT services firm), staffing (an agency posting clients' contracts) or aggregator (a job board re-posting others' jobs). Staffing and aggregator are left out unless named, as on the site's Hiring now tab, or a `company` is named; the answer says how many jobs that left out. Labels come from a curated list: an unlisted company counts as an employer."New value: +"Who may post the jobs; staffing (agencies) and aggregator (job boards) are left out unless named or a `company` is."

Added value: +"The page; the last is 20."

Previous value: -"With `query` or `similar_to` and sort relevance: at most this many rows of one company, besides a listed posting's copy on another of its Boards, before every other company's; its others follow them, and the answer says how many. 3 when not sent, and then not applied with `company`, a sort or no ranking; sent with a sort or no ranking, it is refused. 0 lists the ranking as it is."New value: +"Most rows of one company before others' (3; 0 for none)."

Previous value: -"The role only. Omit to list the newest jobs."New value: +"The role only; omit for the newest jobs."

Previous value: -"A floor on the job's required experience, not the user's: keeps jobs asking for at least this many years ('roles needing 8+ years' is 8), as stated or else estimated from the title's seniority. Jobs whose experience is unknown are left out."New value: +"Jobs asking at least this many years; not the user's own."

Previous value: -"ISO 4217 code, such as USD, INR, EUR, GBP."New value: +"ISO 4217 code, such as USD, INR, EUR."

Previous value: -"Annual; needs salary_currency. Keeps a job whose stated range starts at or below it."New value: +"Annual, in salary_currency: keeps a stated range starting at or below it."

Previous value: -"Annual; needs salary_currency (30 lakh = 3000000 INR). Keeps a job whose stated range reaches it; other currencies are converted at fixed rates."New value: +"Annual, in salary_currency (30 lakh = 3000000 INR): keeps a stated range reaching it."

Previous value: -"A job id from an earlier answer: rank by that job instead of `query`, leaving it out. Not with `query`."New value: +"A job id: rank by that job, leaving it out. Not with `query`."

Previous value: -"salary orders by the low end of each stated range, in salary_currency or else USD. With `query`, any sort orders only the matches scoring at least 0.67 among its 2,000 closest."New value: +"With `query`, orders only matches scoring at least 0.67 among its 2,000 closest; salary by a range's low end."

Previous value: -"Use this, not `keyword`, for visa sponsorship or relocation: a description that mentions sponsorship usually refuses it. offers_sponsorship: the description offers this job visa sponsorship and nothing in it refuses or hedges it; an offer limited to another country than the job's (or a move to another country's city), to levels above its title, or to full-time roles on an internship, does not count. may_offer_sponsorship: those jobs, plus the ones whose offer is hedged ('not guaranteed', 'not for every role', 'case by case', 'may be available', 'if possible', 'subject to approval', 'only if already based in'), is a visa transfer only, or names a country or level the job's place or title does not show; each row says which kind it is, so say it. refuses_sponsorship: it refuses sponsorship ('now or in the future', 'Visa Sponsorship: No'), requires citizenship of this job or work authorisation already held, or offers it only to another country or level; offers_relocation: it offers relocation help. Text-derived, not a field the employer set: HeadStart's rules (headstart.jobs.work_authorization) read each sponsorship, citizenship and relocation sentence with its negation, and read an offer against the job's place, title and type. Of 50 offers_sponsorship jobs drawn from the live index after the rules froze (ADR-0368; 25 in the US, 25 elsewhere, at most 5 a company), read strictly, 47 (0.94) offered this job sponsorship firmly and all 50 at least may; the 0.98 to 0.99 precision on 1,062 hand-read descriptions (ADR-0333 to ADR-0368) is on the rules' own tuning set. Before telling a user a job sponsors visas, read its sponsorship sentences with get_job. A posting without a description never matches."New value: +"What the description says of visas or relocation: an unhedged offer of sponsorship; also hedged or transfer-only offers (rows say which); a refusal or a citizenship requirement; relocation help. Read from the text by HeadStart's rules, so read the job with get_job before telling a user it sponsors."

Previous value: -nullNew value: +{
+  "properties": {
+    "next_page": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "page": {
+      "type": "integer"
+    },
+    "rows": {
+      "items": {
+        "properties": {
+          "company": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "first_seen": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "id": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          },
+          "location": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "min_years": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "posted": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "remote": {
+            "type": "boolean"
+          },
+          "salary_currency": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "salary_max": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "salary_min": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "score": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "title": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "total": {
+      "type": "integer"
+    },
+    "truncated": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "total",
+    "page",
+    "next_page",
+    "rows"
+  ],
+  "type": "object"
+}

Removed value: -3

Previous value: -"With `query` or `similar_to` and sort relevance: at most this many rows of one company, besides a listed posting's copy on another of its Boards, before every other company's; its others follow them, and the answer says how many. 0 lists the ranking as it is. Not applied with `company`."New value: +"With `query` or `similar_to` and sort relevance: at most this many rows of one company, besides a listed posting's copy on another of its Boards, before every other company's; its others follow them, and the answer says how many. 3 when not sent, and then not applied with `company`, a sort or no ranking; sent with a sort or no ranking, it is refused. 0 lists the ranking as it is."