{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 300,
      "description": "Expanded query, embedded verbatim: 'Full Job Title. One sentence of core responsibilities; 3-5 key skills/tools.' Keep user qualifiers (senior, night shift, fintech…). NO abbreviations or acronyms anywhere in the text — always the spelled-out form ('machine learning', not 'ML'; 'registered nurse', not 'RN'; 'software engineer', not 'SWE'); never a single word."
    },
    "city": {
      "type": "string",
      "description": "US city name, e.g. 'Denver' or 'Denver, CO'. Non-US cities are not covered and return no match."
    },
    "state": {
      "type": "string",
      "description": "US state full name or 2-letter code."
    },
    "radius_miles": {
      "type": "integer",
      "description": "10, 30 or 50 (default 50). Only used with city."
    },
    "work_arrangement": {
      "type": "string",
      "enum": [
        "On-site",
        "Hybrid",
        "Remote OK",
        "Remote Solely"
      ]
    },
    "experience_level": {
      "type": "string",
      "enum": [
        "0-2",
        "2-5",
        "5-10",
        "10+"
      ],
      "description": "Years-of-experience band."
    },
    "employment_type": {
      "type": "string",
      "enum": [
        "FULL_TIME",
        "PART_TIME",
        "CONTRACTOR",
        "TEMPORARY",
        "PER_DIEM",
        "INTERN",
        "VOLUNTEER",
        "OTHER"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Default 12."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "For paging; use nextOffset from a previous call."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The job slug from search_jobs results (last path segment of the url)."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "City name prefix, e.g. 'san'."
    },
    "state": {
      "type": "string",
      "description": "Restrict to a state (name or 2-letter code)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}