{
  "openapi": "3.0.3",
  "info": {
    "title": "freehire public API",
    "version": "1.1.0",
    "description": "Public, read-only freehire API: search IT jobs, read the live filter\nvocabulary, inspect job and company details, and find similar jobs. Every\noperation here answers without a key; an API plan's key only raises the rate\nlimit. Keyless use is for personal and non-commercial use — showing the\npostings in a product you offer to others needs an API plan (see the\n[data licence](https://freehire.me/terms#data-licence)). The authenticated tracking surface\n(saved jobs, application stages, CV tooling) is deliberately excluded — this\nschema is the integration contract for search, and is also what the freehire\ncustom GPT imports as an Action.\n\n## Filter grammar\n\nFacet parameters are **repeatable**, and the same grammar applies to all of\nthem:\n\n* `?skills=go&skills=kubernetes` — values of one facet are **ORed**: match\n  either.\n* `?skills=go&skills=kubernetes&skills_mode=and` — `<facet>_mode=and` flips\n  that facet to **AND**: match both. Not available for geography (see below).\n* `?source_exclude=adzuna` — `<facet>_exclude` removes matches. **Every**\n  string facet in this schema declares its `_exclude` twin.\n* Different facets **AND** together: `?work_mode=remote&seniority=senior` is\n  remote *and* senior.\n\n## Geography is one OR-group\n\n`regions`, `countries`, `cities` and `metros` name a single concept — *where* — so\ntheir values join into **one OR-group** instead of intersecting.\n`?countries=gb&cities=London` therefore returns *United Kingdom **or**\nLondon*, which is **wider** than `?countries=gb` alone — not narrower. To\nsearch one place, name only that place.\n\nPicking two places reading as \"either\" is what makes\n`?regions=eu&countries=br` (\"Europe or Brazil\") useful. There is no AND to\nswitch on: `<facet>_mode=and` does not apply to these three.\n\n`?regions=none` is a reserved value that selects postings with **no resolved\ngeography**, rather than a real region code.\n\n## Resolve values before filtering\n\n`skills`, `countries`, `cities`, `category`, `source`,\n`company_slug` and `collections` are open or large vocabularies. Call\n`getJobFacets` (or `searchCities` for a city) to discover canonical values\nwith live counts. The `cities` filter also accepts recognized dictionary\naliases such as `München` and resolves them to the canonical facet value;\n`searchCities` remains useful for discovering or disambiguating a city.\nUnknown values are not an error; they simply match nothing.\n\n## API plans\n\nThe read API is available without a key for personal and non-commercial use.\nAn API plan licenses the data for use in your product — see the\n[data licence](https://freehire.me/terms#data-licence).\nA full-access API key (`fhk_…`) or OAuth access token (`fhm_…`) identifies\nyour account when sent as `Authorization: Bearer <token>`.\n\n## Please say who you are\n\nNot required, not validated, and nothing behaves differently without it —\nevery caller gets the same answers. It is a request.\n\nSend a `User-Agent` naming your project:\n\n```\nacme/job-sync/1.4 (+https://github.com/acme/job-sync)\n```\n\n`owner/project` is the part that matters; the version and contact URL are\nuseful if you have them. What it buys you is a message before a limit or a\nfield changes, instead of a `429` as first notice — a default library\nuser-agent is indistinguishable from a thousand others, so there is nobody\nto warn.\n\nIf identification ever gates anything, it will be through a key we issue,\nnot a string you set yourself.\n\n## An unknown PARAMETER is dropped, and says so\n\nA parameter no filter reads is ignored rather than refused, so old saved\nsearches and shared links keep working. The cost is that `?country=it` —\nsingular, and not the facet's name — returns the entire catalogue, which\nlooks exactly like a search that legitimately matched everything.\n\nSo the response tells you. `meta.ignored_params` lists what was thrown away,\nwith `did_you_mean` when the miss was only grammatical number:\n\n```json\n\"meta\": {\n  \"total\": 1475149, \"limit\": 10, \"offset\": 0,\n  \"ignored_params\": [\n    { \"param\": \"country\", \"did_you_mean\": \"countries\" },\n    { \"param\": \"skil\" }\n  ]\n}\n```\n\n**Check it before trusting a filtered result.** The key is absent on a clean\nrequest, never `[]`, so its presence alone is the signal. `searchJobs`,\n`agentSearchJobs`, `searchCompanies` and `getJobFacets` all report — and\n`getJobFacets` grows a `meta` block it otherwise does not have. The report is\ncapped at ten entries.\n\n`searchCompanies` checks against its OWN vocabulary: a jobs facet sent there\n(`?seniority=senior`) is a real facet name, but not one company search reads,\nso it is ignored and reported.\n\n## An unknown VALUE of a closed facet narrows to nothing, and says so\n\nFacets with a fixed vocabulary (`work_mode`, `regions`, `seniority`,\n`category`, `employment_type`, `education_level`, `company_type`,\n`company_size`, `salary_period`, `relocation`, `english_level`, `role_type`,\n`source_type`, `ai_archetype`, `domains`, `reality`, `perks`, `engagement`, `skills` and the boolean facets) still\napply a value outside it — so `?work_mode=foo` answers `total: 0`, which reads\nexactly like an empty market. `meta.ignored_values` names such values per\nparameter (the `_exclude` form under its own name):\n\n```json\n\"meta\": { \"total\": 0, \"limit\": 10, \"offset\": 0,\n          \"ignored_values\": { \"work_mode\": [\"foo\"] } }\n```\n\nValues are compared case-insensitively. A `skills` value is checked against\nthe skill dictionary that tags postings, so an alias it knows (`golang`) is\nnot unknown — it is read as its canonical slug (`go`). Open facets\n(`countries`, `cities`, `company_slug`, `source`, `collections`,\n`salary_currency`, `posting_language`) are not checked: an unknown value there can be\nlegitimate. Absent on a clean request; capped at ten parameters of ten\nvalues each. Reported by `searchJobs`, `agentSearchJobs` and\n`getJobFacets`.\n",
    "license": {
      "name": "freehire API data licence",
      "url": "https://freehire.me/terms#data-licence"
    }
  },
  "servers": [
    {
      "url": "https://freehire.me/api/v1"
    }
  ],
  "security": [
    {},
    {
      "PersonalApiKey": []
    }
  ],
  "tags": [
    {
      "name": "Jobs",
      "description": "Public, unauthenticated reads. Jobs are returned in one wire shape (addressed by `public_slug`, never an internal id) shared by the list, detail, company, and search responses. Closed postings are excluded from lists and search and served only by the detail endpoint."
    },
    {
      "name": "Companies",
      "description": "Public reads. A company detail also returns a page of its open jobs."
    },
    {
      "name": "Search",
      "description": "Full-text job search with the shared filter vocabulary, facet counts, similar jobs and the reference data behind search."
    }
  ],
  "paths": {
    "/jobs/search": {
      "get": {
        "operationId": "searchJobs",
        "summary": "Full-text + faceted search over open jobs.",
        "description": "Free-text `q` plus any filter (the \"Filtering jobs\" section). Repeated values OR;\n`<param>_mode=and` requires all, `<param>_exclude` excludes. Newest first without `q`,\nby relevance with it. An unread param is listed in `meta.ignored_params`: check it, a\ndropped filter looks like a broad result.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Full-text query over `title`, `company`, `description`, and `location`. The first\nwords are required and trailing ones are dropped when too few postings match, so word\norder can change the result. Operators: quotes require every quoted word in any order\n(not a contiguous phrase); `-word` excludes; uppercase `OR` between words matches any\nalternative (at most 5); `title:` at the start of an alternative matches it in the\ntitle only, e.g. `title:\"product owner\" -junior OR title:produktchef`. `q_fields`\nnarrows the other alternatives. No exact-phrase matching. (e.g. `golang`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "q_fields",
            "in": "query",
            "required": false,
            "description": "Comma-separated subset of `title,company,description,location` to restrict `q` to,\ne.g. `title`. A name outside that set drops the whole parameter (reported in\n`meta.ignored_params`) rather than partially applying. (e.g. `title`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "q_prefix",
            "in": "query",
            "required": false,
            "description": "`true` lets the last word of `q` match as the start of a longer word (`data eng`\nfinds `engineer`), for suggestions while someone is still typing. Off by default:\nthe last word is read as complete, which is much faster on broad queries.\n(e.g. `true`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "One of `created_at`, `posted_at`, `view_count`, `salary_min`, `salary_max`. Omit for\nrelevance/newest. (e.g. `posted_at`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "`asc` or `desc` (default `desc`). (e.g. `desc`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size, 1–100. (e.g. `20`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip; `offset + limit` ≤ 10000. (e.g. `0`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "hide_seen",
            "in": "query",
            "required": false,
            "description": "`true` leaves out the postings the signed-in caller has already opened (the 1000 most\nrecently viewed, saved, applied to or hidden), inside the search, so `meta.total` and\npaging stay accurate. A per-person preference, not a filter: a saved search ignores\nit. Without a session or API key it is not applied and is listed in\n`meta.ignored_params`. (e.g. `true`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "hide_applied_companies",
            "in": "query",
            "required": false,
            "description": "`true` excludes every posting of employers represented in the newest 1,000\napplications made by the signed-in caller. Employers represented only by older\napplications can remain in results. Applied inside the search, so `meta.total` and\npaging describe what is left. A per-person preference, not a filter: a saved search\ncarrying it narrows nothing. Without a session or API key, or with a value that is\nnot a boolean, the search runs unhidden and the param is reported in\n`meta.ignored_params`. (e.g. `true`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "min_skill_match",
            "in": "query",
            "required": false,
            "description": "Keeps only postings whose skills your profile covers by at least this percent\n(1–100), across the whole ranking. Applies only with `sort=match`, to a signed-in\ncaller with profile skills; the read stops once no later posting can qualify or at a\ndepth bound, and then `meta.total` is a minimum with\n`meta.total_is_lower_bound: true`. A per-person preference: a saved search ignores\nit. Otherwise it is not applied and is listed in `meta.ignored_params`. (e.g. `70`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "$ref": "#/components/parameters/job.collections"
          },
          {
            "$ref": "#/components/parameters/job.collections_exclude"
          },
          {
            "$ref": "#/components/parameters/job.collections_mode"
          },
          {
            "$ref": "#/components/parameters/job.regions"
          },
          {
            "$ref": "#/components/parameters/job.regions_exclude"
          },
          {
            "$ref": "#/components/parameters/job.work_mode"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_exclude"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_mode"
          },
          {
            "$ref": "#/components/parameters/job.category"
          },
          {
            "$ref": "#/components/parameters/job.category_exclude"
          },
          {
            "$ref": "#/components/parameters/job.category_mode"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype_exclude"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype_mode"
          },
          {
            "$ref": "#/components/parameters/job.seniority"
          },
          {
            "$ref": "#/components/parameters/job.seniority_exclude"
          },
          {
            "$ref": "#/components/parameters/job.seniority_mode"
          },
          {
            "$ref": "#/components/parameters/job.role_type"
          },
          {
            "$ref": "#/components/parameters/job.role_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.role_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.skills"
          },
          {
            "$ref": "#/components/parameters/job.skills_exclude"
          },
          {
            "$ref": "#/components/parameters/job.skills_mode"
          },
          {
            "$ref": "#/components/parameters/job.domains"
          },
          {
            "$ref": "#/components/parameters/job.domains_exclude"
          },
          {
            "$ref": "#/components/parameters/job.domains_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_type"
          },
          {
            "$ref": "#/components/parameters/job.company_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.countries"
          },
          {
            "$ref": "#/components/parameters/job.countries_exclude"
          },
          {
            "$ref": "#/components/parameters/job.cities"
          },
          {
            "$ref": "#/components/parameters/job.cities_exclude"
          },
          {
            "$ref": "#/components/parameters/job.metros"
          },
          {
            "$ref": "#/components/parameters/job.metros_exclude"
          },
          {
            "$ref": "#/components/parameters/job.relocation"
          },
          {
            "$ref": "#/components/parameters/job.relocation_exclude"
          },
          {
            "$ref": "#/components/parameters/job.relocation_mode"
          },
          {
            "$ref": "#/components/parameters/job.employment_type"
          },
          {
            "$ref": "#/components/parameters/job.employment_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.employment_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.engagement"
          },
          {
            "$ref": "#/components/parameters/job.engagement_exclude"
          },
          {
            "$ref": "#/components/parameters/job.engagement_mode"
          },
          {
            "$ref": "#/components/parameters/job.english_level"
          },
          {
            "$ref": "#/components/parameters/job.english_level_exclude"
          },
          {
            "$ref": "#/components/parameters/job.english_level_mode"
          },
          {
            "$ref": "#/components/parameters/job.posting_language"
          },
          {
            "$ref": "#/components/parameters/job.posting_language_exclude"
          },
          {
            "$ref": "#/components/parameters/job.posting_language_mode"
          },
          {
            "$ref": "#/components/parameters/job.reality"
          },
          {
            "$ref": "#/components/parameters/job.reality_exclude"
          },
          {
            "$ref": "#/components/parameters/job.reality_mode"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency_exclude"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency_mode"
          },
          {
            "$ref": "#/components/parameters/job.perks"
          },
          {
            "$ref": "#/components/parameters/job.perks_exclude"
          },
          {
            "$ref": "#/components/parameters/job.perks_mode"
          },
          {
            "$ref": "#/components/parameters/job.equity"
          },
          {
            "$ref": "#/components/parameters/job.equity_exclude"
          },
          {
            "$ref": "#/components/parameters/job.equity_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_slug"
          },
          {
            "$ref": "#/components/parameters/job.company_slug_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_slug_mode"
          },
          {
            "$ref": "#/components/parameters/job.source_type"
          },
          {
            "$ref": "#/components/parameters/job.source_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.source_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels_exclude"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels_mode"
          },
          {
            "$ref": "#/components/parameters/job.source"
          },
          {
            "$ref": "#/components/parameters/job.source_exclude"
          },
          {
            "$ref": "#/components/parameters/job.source_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_size"
          },
          {
            "$ref": "#/components/parameters/job.company_size_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_size_mode"
          },
          {
            "$ref": "#/components/parameters/job.education_level"
          },
          {
            "$ref": "#/components/parameters/job.education_level_exclude"
          },
          {
            "$ref": "#/components/parameters/job.education_level_mode"
          },
          {
            "$ref": "#/components/parameters/job.salary_period"
          },
          {
            "$ref": "#/components/parameters/job.salary_period_exclude"
          },
          {
            "$ref": "#/components/parameters/job.salary_period_mode"
          },
          {
            "$ref": "#/components/parameters/job.is_tech"
          },
          {
            "$ref": "#/components/parameters/job.is_tech_exclude"
          },
          {
            "$ref": "#/components/parameters/job.is_tech_mode"
          },
          {
            "$ref": "#/components/parameters/job.visa_sponsorship"
          },
          {
            "$ref": "#/components/parameters/job.requires_clearance"
          },
          {
            "$ref": "#/components/parameters/job.via_recruiter"
          },
          {
            "$ref": "#/components/parameters/job.former_employers"
          },
          {
            "$ref": "#/components/parameters/job.watchlist"
          },
          {
            "$ref": "#/components/parameters/job.salary_min"
          },
          {
            "$ref": "#/components/parameters/job.salary_max"
          },
          {
            "$ref": "#/components/parameters/job.experience_years_min"
          },
          {
            "$ref": "#/components/parameters/job.experience_years_max"
          },
          {
            "$ref": "#/components/parameters/job.experience_include_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.experience_only_seniority_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.seniority_include_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.posted_within_days"
          },
          {
            "$ref": "#/components/parameters/job.open_within_days"
          },
          {
            "$ref": "#/components/parameters/job.apply_questions_max"
          },
          {
            "$ref": "#/components/parameters/job.auto_apply_available"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_anywhere"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_regions"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_countries"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "headers": {
              "Cache-Control": {
                "required": false,
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Job"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/JobSearchMeta"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "public_slug": "senior-go-engineer-acme-1a2b",
                      "title": "Senior Go Engineer",
                      "company": "Acme",
                      "company_slug": "acme",
                      "location": "Berlin, Germany",
                      "work_mode": "remote",
                      "skills": [
                        "go",
                        "postgresql"
                      ]
                    }
                  ],
                  "meta": {
                    "total": 137,
                    "limit": 20,
                    "offset": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters or search query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/agent/jobs/search": {
      "get": {
        "operationId": "agentSearchJobs",
        "summary": "Search with full descriptions, for programmatic/agent consumers.",
        "description": "Same text query and facet filters as `/jobs/search`, but each result carries the\n`description` in full (verbatim from the database) instead of the truncated index\npreview. Use `description_format` to choose how it is rendered.\n\nPlus every filter in the \"Filtering jobs\" section.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Full-text query over `title`, `company`, `description`, and `location`. The first\nwords are required and trailing ones are dropped when too few postings match, so word\norder can change the result. Operators: quotes require every quoted word in any order\n(not a contiguous phrase); `-word` excludes; uppercase `OR` between words matches any\nalternative (at most 5); `title:` at the start of an alternative matches it in the\ntitle only, e.g. `title:\"product owner\" -junior OR title:produktchef`. `q_fields`\nnarrows the other alternatives. No exact-phrase matching. (e.g. `golang`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "q_fields",
            "in": "query",
            "required": false,
            "description": "Comma-separated subset of `title,company,description,location` to restrict `q` to,\ne.g. `title`. A name outside that set drops the whole parameter (reported in\n`meta.ignored_params`) rather than partially applying. (e.g. `title`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "q_prefix",
            "in": "query",
            "required": false,
            "description": "`true` lets the last word of `q` match as the start of a longer word (`data eng`\nfinds `engineer`), for suggestions while someone is still typing. Off by default:\nthe last word is read as complete, which is much faster on broad queries.\n(e.g. `true`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "One of `created_at`, `posted_at`, `view_count`, `salary_min`, `salary_max`. Omit for\nrelevance/newest. (e.g. `posted_at`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "`asc` or `desc` (default `desc`). (e.g. `desc`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size, 1–100. (e.g. `20`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip; `offset + limit` ≤ 10000. (e.g. `0`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "description_format",
            "in": "query",
            "required": false,
            "description": "`text` or `markdown`; anything else leaves the stored HTML.",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "semantic",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "$ref": "#/components/parameters/job.collections"
          },
          {
            "$ref": "#/components/parameters/job.collections_exclude"
          },
          {
            "$ref": "#/components/parameters/job.collections_mode"
          },
          {
            "$ref": "#/components/parameters/job.regions"
          },
          {
            "$ref": "#/components/parameters/job.regions_exclude"
          },
          {
            "$ref": "#/components/parameters/job.work_mode"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_exclude"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_mode"
          },
          {
            "$ref": "#/components/parameters/job.category"
          },
          {
            "$ref": "#/components/parameters/job.category_exclude"
          },
          {
            "$ref": "#/components/parameters/job.category_mode"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype_exclude"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype_mode"
          },
          {
            "$ref": "#/components/parameters/job.seniority"
          },
          {
            "$ref": "#/components/parameters/job.seniority_exclude"
          },
          {
            "$ref": "#/components/parameters/job.seniority_mode"
          },
          {
            "$ref": "#/components/parameters/job.role_type"
          },
          {
            "$ref": "#/components/parameters/job.role_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.role_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.skills"
          },
          {
            "$ref": "#/components/parameters/job.skills_exclude"
          },
          {
            "$ref": "#/components/parameters/job.skills_mode"
          },
          {
            "$ref": "#/components/parameters/job.domains"
          },
          {
            "$ref": "#/components/parameters/job.domains_exclude"
          },
          {
            "$ref": "#/components/parameters/job.domains_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_type"
          },
          {
            "$ref": "#/components/parameters/job.company_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.countries"
          },
          {
            "$ref": "#/components/parameters/job.countries_exclude"
          },
          {
            "$ref": "#/components/parameters/job.cities"
          },
          {
            "$ref": "#/components/parameters/job.cities_exclude"
          },
          {
            "$ref": "#/components/parameters/job.metros"
          },
          {
            "$ref": "#/components/parameters/job.metros_exclude"
          },
          {
            "$ref": "#/components/parameters/job.relocation"
          },
          {
            "$ref": "#/components/parameters/job.relocation_exclude"
          },
          {
            "$ref": "#/components/parameters/job.relocation_mode"
          },
          {
            "$ref": "#/components/parameters/job.employment_type"
          },
          {
            "$ref": "#/components/parameters/job.employment_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.employment_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.engagement"
          },
          {
            "$ref": "#/components/parameters/job.engagement_exclude"
          },
          {
            "$ref": "#/components/parameters/job.engagement_mode"
          },
          {
            "$ref": "#/components/parameters/job.english_level"
          },
          {
            "$ref": "#/components/parameters/job.english_level_exclude"
          },
          {
            "$ref": "#/components/parameters/job.english_level_mode"
          },
          {
            "$ref": "#/components/parameters/job.posting_language"
          },
          {
            "$ref": "#/components/parameters/job.posting_language_exclude"
          },
          {
            "$ref": "#/components/parameters/job.posting_language_mode"
          },
          {
            "$ref": "#/components/parameters/job.reality"
          },
          {
            "$ref": "#/components/parameters/job.reality_exclude"
          },
          {
            "$ref": "#/components/parameters/job.reality_mode"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency_exclude"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency_mode"
          },
          {
            "$ref": "#/components/parameters/job.perks"
          },
          {
            "$ref": "#/components/parameters/job.perks_exclude"
          },
          {
            "$ref": "#/components/parameters/job.perks_mode"
          },
          {
            "$ref": "#/components/parameters/job.equity"
          },
          {
            "$ref": "#/components/parameters/job.equity_exclude"
          },
          {
            "$ref": "#/components/parameters/job.equity_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_slug"
          },
          {
            "$ref": "#/components/parameters/job.company_slug_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_slug_mode"
          },
          {
            "$ref": "#/components/parameters/job.source_type"
          },
          {
            "$ref": "#/components/parameters/job.source_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.source_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels_exclude"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels_mode"
          },
          {
            "$ref": "#/components/parameters/job.source"
          },
          {
            "$ref": "#/components/parameters/job.source_exclude"
          },
          {
            "$ref": "#/components/parameters/job.source_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_size"
          },
          {
            "$ref": "#/components/parameters/job.company_size_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_size_mode"
          },
          {
            "$ref": "#/components/parameters/job.education_level"
          },
          {
            "$ref": "#/components/parameters/job.education_level_exclude"
          },
          {
            "$ref": "#/components/parameters/job.education_level_mode"
          },
          {
            "$ref": "#/components/parameters/job.salary_period"
          },
          {
            "$ref": "#/components/parameters/job.salary_period_exclude"
          },
          {
            "$ref": "#/components/parameters/job.salary_period_mode"
          },
          {
            "$ref": "#/components/parameters/job.is_tech"
          },
          {
            "$ref": "#/components/parameters/job.is_tech_exclude"
          },
          {
            "$ref": "#/components/parameters/job.is_tech_mode"
          },
          {
            "$ref": "#/components/parameters/job.visa_sponsorship"
          },
          {
            "$ref": "#/components/parameters/job.requires_clearance"
          },
          {
            "$ref": "#/components/parameters/job.via_recruiter"
          },
          {
            "$ref": "#/components/parameters/job.former_employers"
          },
          {
            "$ref": "#/components/parameters/job.watchlist"
          },
          {
            "$ref": "#/components/parameters/job.salary_min"
          },
          {
            "$ref": "#/components/parameters/job.salary_max"
          },
          {
            "$ref": "#/components/parameters/job.experience_years_min"
          },
          {
            "$ref": "#/components/parameters/job.experience_years_max"
          },
          {
            "$ref": "#/components/parameters/job.experience_include_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.experience_only_seniority_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.seniority_include_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.posted_within_days"
          },
          {
            "$ref": "#/components/parameters/job.open_within_days"
          },
          {
            "$ref": "#/components/parameters/job.apply_questions_max"
          },
          {
            "$ref": "#/components/parameters/job.auto_apply_available"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_anywhere"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_regions"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_countries"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "headers": {
              "Cache-Control": {
                "required": false,
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Job"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/AgentJobSearchMeta"
                    }
                  }
                },
                "example": {
                  "data": [
                    {
                      "public_slug": "senior-go-engineer-acme-1a2b",
                      "title": "Senior Go Engineer",
                      "company": "Acme",
                      "company_slug": "acme",
                      "location": "Berlin, Germany",
                      "work_mode": "remote",
                      "skills": [
                        "go",
                        "postgresql"
                      ],
                      "description": "## About the role\nYou will build the payments API."
                    }
                  ],
                  "meta": {
                    "total": 137,
                    "limit": 20,
                    "offset": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters or search query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/ojcp/v1/search": {
      "post": {
        "operationId": "ojcpSearchJobs",
        "tags": [
          "Jobs"
        ],
        "summary": "OJCP: search jobs",
        "description": "The `search_jobs` tool of the [Open Job Context Protocol](https://spec.ojcp.dev/) over REST: each result is an OJCP `JobPosting` with the paths it can be applied through. Discovery: `/.well-known/ojcp.json`; MCP: `/api/v1/ojcp/mcp`. A filter it cannot honour is named in `ignored_params`.",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "An OJCP `search_jobs` input. Unrecognised fields are ignored rather than\nrefused, per the standard's extensibility rule.\n",
                "properties": {
                  "query": {
                    "type": "string"
                  },
                  "location": {
                    "type": "object",
                    "properties": {
                      "city": {
                        "type": "string"
                      },
                      "country": {
                        "type": "string"
                      },
                      "remote_ok": {
                        "type": "boolean"
                      }
                    }
                  },
                  "filters": {
                    "type": "object",
                    "properties": {
                      "employment_type": {
                        "type": "string"
                      },
                      "experience_level": {
                        "type": "string"
                      },
                      "salary_min": {
                        "type": "number"
                      },
                      "salary_max": {
                        "type": "number"
                      },
                      "posted_within_days": {
                        "type": "integer"
                      }
                    }
                  },
                  "pagination": {
                    "type": "object",
                    "properties": {
                      "limit": {
                        "type": "integer",
                        "maximum": 50,
                        "default": 10
                      },
                      "offset": {
                        "type": "integer",
                        "default": 0
                      }
                    }
                  },
                  "semantic": {
                    "type": "boolean",
                    "description": "Extension. `true` asks for meaning-based ranking, which is\ncurrently not available: the answer is the keyword search and\n`semantic` says `unavailable`. Without a non-empty `query` it is\nreported in `ignored_params` instead.\n"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "An OJCP search-jobs response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ojcp_version",
                    "query",
                    "total_results",
                    "returned",
                    "offset",
                    "jobs"
                  ],
                  "properties": {
                    "ojcp_version": {
                      "type": "string"
                    },
                    "query": {
                      "type": "string"
                    },
                    "total_results": {
                      "type": "integer"
                    },
                    "returned": {
                      "type": "integer"
                    },
                    "offset": {
                      "type": "integer"
                    },
                    "jobs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "An OJCP JobPosting."
                      }
                    },
                    "ignored_params": {
                      "type": "array",
                      "description": "Input fields this provider could not honour.",
                      "items": {
                        "type": "string"
                      }
                    },
                    "semantic": {
                      "type": "string",
                      "enum": [
                        "applied",
                        "unavailable"
                      ],
                      "description": "Extension. Which search answered a request that sent\n`semantic: true`; omitted when it did not.\n"
                    },
                    "total_is_lower_bound": {
                      "type": "boolean",
                      "description": "Extension. True when `total_results` is a minimum (what this\npage reaches, plus one when there is a next page), not a count\nof the match.\n"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "OJCP error `invalid_request`: the body is not valid JSON.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ojcp_version",
                    "error_code",
                    "message"
                  ],
                  "properties": {
                    "ojcp_version": {
                      "type": "string"
                    },
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "OJCP error `provider_error`: search is unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ojcp_version",
                    "error_code",
                    "message"
                  ],
                  "properties": {
                    "ojcp_version": {
                      "type": "string"
                    },
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-openai-isConsequential": false
      }
    },
    "/ojcp/v1/jobs/{slug}": {
      "get": {
        "operationId": "ojcpJobDetail",
        "tags": [
          "Jobs"
        ],
        "summary": "OJCP: read one posting",
        "description": "The `get_job_detail` tool, by the `ojcp_id` a search result carries.\n",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The posting's ojcp_id (its public_slug)."
          }
        ],
        "responses": {
          "200": {
            "description": "An OJCP job-detail response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ojcp_version",
                    "job"
                  ],
                  "properties": {
                    "ojcp_version": {
                      "type": "string"
                    },
                    "job": {
                      "type": "object",
                      "description": "An OJCP JobPosting."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "OJCP error `job_not_found`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ojcp_version",
                    "error_code",
                    "message"
                  ],
                  "properties": {
                    "ojcp_version": {
                      "type": "string"
                    },
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-openai-isConsequential": false
      }
    },
    "/ojcp/v1/employers/{slug}": {
      "get": {
        "operationId": "ojcpEmployerContext",
        "tags": [
          "Companies"
        ],
        "summary": "OJCP: read an employer",
        "description": "The `get_employer_context` tool, by the `ojcp_employer_id` a posting carries.\nIncludes `open_roles_count`, the one figure a single posting cannot state.\n",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The employer's ojcp_employer_id (its company slug)."
          }
        ],
        "responses": {
          "200": {
            "description": "An OJCP employer-context response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ojcp_version",
                    "employer_id",
                    "name"
                  ],
                  "properties": {
                    "ojcp_version": {
                      "type": "string"
                    },
                    "employer_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "industries": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "open_roles_count": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "OJCP error `employer_not_found`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ojcp_version",
                    "error_code",
                    "message"
                  ],
                  "properties": {
                    "ojcp_version": {
                      "type": "string"
                    },
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-openai-isConsequential": false
      }
    },
    "/jobs/facets": {
      "get": {
        "operationId": "getJobFacets",
        "summary": "Count of matching jobs per facet value (and numeric stats).",
        "description": "The same `q` and filters as search, answered with the count of postings per facet value\nand `stats` (min/max) for the numeric facets. `former_employers` and `watchlist` are\nignored. Narrow with `facets=`; naming `company_slug` there adds `companies_total` and\n`top_companies`.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Same full-text query as search. (e.g. `golang`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "facets",
            "in": "query",
            "required": false,
            "description": "Comma-separated facet params to count instead of all of them, e.g. `skills,seniority`.\n`company_slug` is counted only when named here. An unknown name is a 400, and so is\ncombining it with `disjunctive`, or `company_slug` with an `OR` query.",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "disjunctive",
            "in": "query",
            "required": false,
            "description": "`true` counts each facet under the full filter MINUS its own selection, so a selected\nfacet still shows its siblings' counts — what a live filter sidebar wants. Costs one\nquery per facet.",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "$ref": "#/components/parameters/job.collections"
          },
          {
            "$ref": "#/components/parameters/job.collections_exclude"
          },
          {
            "$ref": "#/components/parameters/job.collections_mode"
          },
          {
            "$ref": "#/components/parameters/job.regions"
          },
          {
            "$ref": "#/components/parameters/job.regions_exclude"
          },
          {
            "$ref": "#/components/parameters/job.work_mode"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_exclude"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_mode"
          },
          {
            "$ref": "#/components/parameters/job.category"
          },
          {
            "$ref": "#/components/parameters/job.category_exclude"
          },
          {
            "$ref": "#/components/parameters/job.category_mode"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype_exclude"
          },
          {
            "$ref": "#/components/parameters/job.ai_archetype_mode"
          },
          {
            "$ref": "#/components/parameters/job.seniority"
          },
          {
            "$ref": "#/components/parameters/job.seniority_exclude"
          },
          {
            "$ref": "#/components/parameters/job.seniority_mode"
          },
          {
            "$ref": "#/components/parameters/job.role_type"
          },
          {
            "$ref": "#/components/parameters/job.role_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.role_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.skills"
          },
          {
            "$ref": "#/components/parameters/job.skills_exclude"
          },
          {
            "$ref": "#/components/parameters/job.skills_mode"
          },
          {
            "$ref": "#/components/parameters/job.domains"
          },
          {
            "$ref": "#/components/parameters/job.domains_exclude"
          },
          {
            "$ref": "#/components/parameters/job.domains_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_type"
          },
          {
            "$ref": "#/components/parameters/job.company_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.countries"
          },
          {
            "$ref": "#/components/parameters/job.countries_exclude"
          },
          {
            "$ref": "#/components/parameters/job.cities"
          },
          {
            "$ref": "#/components/parameters/job.cities_exclude"
          },
          {
            "$ref": "#/components/parameters/job.metros"
          },
          {
            "$ref": "#/components/parameters/job.metros_exclude"
          },
          {
            "$ref": "#/components/parameters/job.relocation"
          },
          {
            "$ref": "#/components/parameters/job.relocation_exclude"
          },
          {
            "$ref": "#/components/parameters/job.relocation_mode"
          },
          {
            "$ref": "#/components/parameters/job.employment_type"
          },
          {
            "$ref": "#/components/parameters/job.employment_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.employment_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.engagement"
          },
          {
            "$ref": "#/components/parameters/job.engagement_exclude"
          },
          {
            "$ref": "#/components/parameters/job.engagement_mode"
          },
          {
            "$ref": "#/components/parameters/job.english_level"
          },
          {
            "$ref": "#/components/parameters/job.english_level_exclude"
          },
          {
            "$ref": "#/components/parameters/job.english_level_mode"
          },
          {
            "$ref": "#/components/parameters/job.posting_language"
          },
          {
            "$ref": "#/components/parameters/job.posting_language_exclude"
          },
          {
            "$ref": "#/components/parameters/job.posting_language_mode"
          },
          {
            "$ref": "#/components/parameters/job.reality"
          },
          {
            "$ref": "#/components/parameters/job.reality_exclude"
          },
          {
            "$ref": "#/components/parameters/job.reality_mode"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency_exclude"
          },
          {
            "$ref": "#/components/parameters/job.salary_currency_mode"
          },
          {
            "$ref": "#/components/parameters/job.perks"
          },
          {
            "$ref": "#/components/parameters/job.perks_exclude"
          },
          {
            "$ref": "#/components/parameters/job.perks_mode"
          },
          {
            "$ref": "#/components/parameters/job.equity"
          },
          {
            "$ref": "#/components/parameters/job.equity_exclude"
          },
          {
            "$ref": "#/components/parameters/job.equity_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_slug"
          },
          {
            "$ref": "#/components/parameters/job.company_slug_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_slug_mode"
          },
          {
            "$ref": "#/components/parameters/job.source_type"
          },
          {
            "$ref": "#/components/parameters/job.source_type_exclude"
          },
          {
            "$ref": "#/components/parameters/job.source_type_mode"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels_exclude"
          },
          {
            "$ref": "#/components/parameters/job.clearance_levels_mode"
          },
          {
            "$ref": "#/components/parameters/job.source"
          },
          {
            "$ref": "#/components/parameters/job.source_exclude"
          },
          {
            "$ref": "#/components/parameters/job.source_mode"
          },
          {
            "$ref": "#/components/parameters/job.company_size"
          },
          {
            "$ref": "#/components/parameters/job.company_size_exclude"
          },
          {
            "$ref": "#/components/parameters/job.company_size_mode"
          },
          {
            "$ref": "#/components/parameters/job.education_level"
          },
          {
            "$ref": "#/components/parameters/job.education_level_exclude"
          },
          {
            "$ref": "#/components/parameters/job.education_level_mode"
          },
          {
            "$ref": "#/components/parameters/job.salary_period"
          },
          {
            "$ref": "#/components/parameters/job.salary_period_exclude"
          },
          {
            "$ref": "#/components/parameters/job.salary_period_mode"
          },
          {
            "$ref": "#/components/parameters/job.is_tech"
          },
          {
            "$ref": "#/components/parameters/job.is_tech_exclude"
          },
          {
            "$ref": "#/components/parameters/job.is_tech_mode"
          },
          {
            "$ref": "#/components/parameters/job.visa_sponsorship"
          },
          {
            "$ref": "#/components/parameters/job.requires_clearance"
          },
          {
            "$ref": "#/components/parameters/job.via_recruiter"
          },
          {
            "$ref": "#/components/parameters/job.former_employers"
          },
          {
            "$ref": "#/components/parameters/job.watchlist"
          },
          {
            "$ref": "#/components/parameters/job.salary_min"
          },
          {
            "$ref": "#/components/parameters/job.salary_max"
          },
          {
            "$ref": "#/components/parameters/job.experience_years_min"
          },
          {
            "$ref": "#/components/parameters/job.experience_years_max"
          },
          {
            "$ref": "#/components/parameters/job.experience_include_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.experience_only_seniority_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.seniority_include_unspecified"
          },
          {
            "$ref": "#/components/parameters/job.posted_within_days"
          },
          {
            "$ref": "#/components/parameters/job.open_within_days"
          },
          {
            "$ref": "#/components/parameters/job.apply_questions_max"
          },
          {
            "$ref": "#/components/parameters/job.auto_apply_available"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_anywhere"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_regions"
          },
          {
            "$ref": "#/components/parameters/job.work_mode_remote_countries"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/JobFacetCounts"
                    },
                    "meta": {
                      "$ref": "#/components/schemas/IgnoredMeta"
                    }
                  },
                  "description": "A single item that read query params: `{\"data\": ...}`, plus `meta` when one was dropped."
                },
                "example": {
                  "data": {
                    "total": 1820,
                    "facets": {
                      "seniority": {
                        "senior": 640,
                        "middle": 410,
                        "junior": 120
                      },
                      "category": {
                        "backend": 700,
                        "frontend": 380
                      }
                    },
                    "stats": {
                      "salary_min": {
                        "min": 20000,
                        "max": 400000
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters, unknown facet, or incompatible facet options.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/suggest": {
      "get": {
        "operationId": "getSuggestions",
        "summary": "Complete what is being typed into a search box.",
        "description": "Completes a PHRASE, not a word: `senior software engineer go` completes to Senior\nSoftware Engineer at Google. Each row carries every part it names; apply them all.\nTypos are forgiven in the trailing fragment only. An empty `q` returns no rows. 503 when\nsearch is not configured.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "The partly-typed query, matched against posting titles, skills, categories and companies.",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "1 to 20, default 5. A value that does not read falls back to the default.",
            "schema": {
              "type": "string"
            },
            "explode": false
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Suggestion"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/SuggestMeta"
                    }
                  },
                  "required": [
                    "data",
                    "meta"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters (including a NUL byte in the query).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/jobs/{slug}": {
      "get": {
        "operationId": "getJob",
        "summary": "A single job by its public slug (serves closed jobs too).",
        "description": "One job by public slug. A signed-in caller also gets their own vote and auto-apply\nstatus. A slug that no longer exists still answers with its posting when its shortcode\nnames exactly one.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The job `public_slug`. (e.g. `senior-go-engineer-acme-1a2b`)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Job"
                    }
                  },
                  "description": "A single item: `{\"data\": ...}`."
                },
                "example": {
                  "data": {
                    "public_slug": "senior-go-engineer-acme-1a2b",
                    "title": "Senior Go Engineer",
                    "company": "Acme",
                    "closed_at": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Job not found or not publicly visible.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Jobs"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/jobs/{slug}/similar": {
      "get": {
        "operationId": "getSimilarJobs",
        "summary": "Similar jobs within the same location and specialization.",
        "description": "Searches the live Meilisearch index with the source job’s known location and\nspecialization as mandatory filters, ranked by keyword search on its title. Returns an\nempty list when location or specialization is unknown or no visible matches remain.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The job `public_slug`. (e.g. `senior-go-engineer-acme-1a2b`)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Max similar jobs. (e.g. `10`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Job"
                      }
                    }
                  },
                  "description": "A single item: `{\"data\": ...}`."
                },
                "example": {
                  "data": [
                    {
                      "public_slug": "senior-go-engineer-acme-1a2b",
                      "title": "Senior Go Engineer",
                      "company": "Acme"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Job not found or not publicly visible.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/companies": {
      "get": {
        "operationId": "searchCompanies",
        "summary": "List companies with job counts and denormalized facets; optional filters.",
        "description": "Most active first. Facet params are repeatable and filter by array overlap (OR within a\nfacet, AND across facets), composably with `q`. `meta.total` reports the count matching\nthe full filter.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Case-insensitive name substring filter. (e.g. `acme`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size, 1–100. (e.g. `20`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. (e.g. `0`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "$ref": "#/components/parameters/company.collections"
          },
          {
            "$ref": "#/components/parameters/company.regions"
          },
          {
            "$ref": "#/components/parameters/company.remote_regions"
          },
          {
            "$ref": "#/components/parameters/company.countries"
          },
          {
            "$ref": "#/components/parameters/company.industries"
          },
          {
            "$ref": "#/components/parameters/company.company_type"
          },
          {
            "$ref": "#/components/parameters/company.company_size"
          },
          {
            "$ref": "#/components/parameters/company.maturity"
          },
          {
            "$ref": "#/components/parameters/company.yc_status"
          },
          {
            "$ref": "#/components/parameters/company.yc_stage"
          },
          {
            "$ref": "#/components/parameters/company.yc_flags"
          },
          {
            "$ref": "#/components/parameters/company.yc_batch"
          },
          {
            "$ref": "#/components/parameters/company.domains"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CompanyListItem"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/ListMeta"
                    }
                  },
                  "description": "A list: `{\"data\": [...], \"meta\": {...}}`."
                },
                "example": {
                  "data": [
                    {
                      "slug": "acme",
                      "name": "Acme",
                      "job_count": 12,
                      "tagline": "Payments for builders",
                      "industries": [
                        "payments"
                      ],
                      "hq_country": "DE",
                      "collections": [
                        "yc"
                      ],
                      "feedback_count": 1,
                      "feedback_rating_avg": null
                    }
                  ],
                  "meta": {
                    "total": 1,
                    "limit": 20,
                    "offset": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters or pagination window exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Companies"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/companies/{slug}": {
      "get": {
        "operationId": "getCompany",
        "summary": "A company and a page of its open jobs.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The company slug.",
            "schema": {
              "type": "string"
            },
            "example": "acme"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size for the jobs list.",
            "schema": {
              "type": "integer"
            },
            "example": 20
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip in the jobs list.",
            "schema": {
              "type": "integer"
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "company": {
                      "slug": "acme",
                      "name": "Acme",
                      "job_count": 12,
                      "collections": [
                        "yc"
                      ],
                      "regions": [
                        "eu"
                      ],
                      "countries": [
                        "DE"
                      ],
                      "domains": [
                        "fintech"
                      ],
                      "company_types": [
                        "product"
                      ],
                      "company_sizes": [
                        "51-200"
                      ],
                      "industries": [
                        "payments"
                      ],
                      "year_founded": 2015,
                      "employee_count": 120,
                      "hq_country": "DE",
                      "organization_type": "private",
                      "tagline": "Payments for builders",
                      "company_info": {
                        "...": "..."
                      },
                      "remote_regions": [
                        "eu"
                      ],
                      "yc_batch": [
                        "W21"
                      ],
                      "yc_status": [
                        "active"
                      ],
                      "yc_stage": [
                        "series-a"
                      ],
                      "yc_flags": [
                        "hiring"
                      ],
                      "maturity": "growth"
                    },
                    "jobs": [
                      {
                        "public_slug": "senior-go-engineer-acme-1a2b",
                        "title": "Senior Go Engineer",
                        "company": "Acme"
                      }
                    ]
                  }
                },
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CompanyPage"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination parameters or pagination window exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Company not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Companies"
        ],
        "x-openai-isConsequential": false
      }
    },
    "/geo/cities": {
      "get": {
        "operationId": "searchCities",
        "summary": "Prefix-search city names for autocomplete.",
        "description": "Population-ranked prefix search over the embedded city dictionary, optionally narrowed\nto one country. A blank `q` returns an empty list.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Prefix to match. (e.g. `berl`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "ISO 3166-1 alpha-2 code to narrow to. (e.g. `DE`)",
            "schema": {
              "type": "string"
            },
            "explode": false
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CityMatch"
                      }
                    }
                  },
                  "description": "A single item: `{\"data\": ...}`."
                },
                "example": {
                  "data": [
                    {
                      "value": "Berlin",
                      "country": "DE"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters (including a NUL byte in the query).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "x-openai-isConsequential": false
      }
    }
  },
  "components": {
    "securitySchemes": {
      "PersonalApiKey": {
        "type": "http",
        "scheme": "Bearer",
        "description": "Personal API key sent as `Authorization: Bearer <token>`."
      }
    },
    "parameters": {
      "job.collections": {
        "name": "collections",
        "in": "query",
        "description": "Collection: yc, techstars, a16z-portfolio, a16z-speedrun, sequoia, accel, greylock, usv, bond, lightspeed, index-ventures, softbank-vision-fund, founders-fund, european, ai, mag7, bigtech, unicorn, fortune500, eastern-roots, indian-roots, ai-native, uk-skilled-worker-sponsor, nl-recognised-sponsor, us-h1b-sponsor, ca-lmia-employer, ie-permit-employer, dk-fast-track-company.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.collections_exclude": {
        "name": "collections_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `collections` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.collections_mode": {
        "name": "collections_mode",
        "in": "query",
        "description": "`and` requires every listed `collections` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.regions": {
        "name": "regions",
        "in": "query",
        "description": "Region.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "global",
              "north_america",
              "latam",
              "eu",
              "uk",
              "mena",
              "africa",
              "apac",
              "cis",
              "none"
            ]
          }
        }
      },
      "job.regions_exclude": {
        "name": "regions_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `regions` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "global",
              "north_america",
              "latam",
              "eu",
              "uk",
              "mena",
              "africa",
              "apac",
              "cis",
              "none"
            ]
          }
        }
      },
      "job.work_mode": {
        "name": "work_mode",
        "in": "query",
        "description": "Work format.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "remote",
              "hybrid",
              "onsite"
            ]
          }
        }
      },
      "job.work_mode_exclude": {
        "name": "work_mode_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `work_mode` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "remote",
              "hybrid",
              "onsite"
            ]
          }
        }
      },
      "job.work_mode_mode": {
        "name": "work_mode_mode",
        "in": "query",
        "description": "`and` requires every listed `work_mode` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.category": {
        "name": "category",
        "in": "query",
        "description": "Specialization: The retired value management is still accepted and answered as role_type=people_manager.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "software_engineering",
              "backend",
              "frontend",
              "fullstack",
              "mobile",
              "devops",
              "sre",
              "network_engineering",
              "system_administration",
              "telecommunications_engineering",
              "it_support",
              "data_engineering",
              "data_science",
              "data_analytics",
              "ml_ai",
              "ai_engineering",
              "qa",
              "security",
              "hardware",
              "embedded",
              "blockchain",
              "architecture",
              "design",
              "creative",
              "engineering_design",
              "industrial_engineering",
              "occupational_safety",
              "product",
              "project_management",
              "healthcare",
              "skilled_trades",
              "retail",
              "hospitality",
              "logistics",
              "education",
              "personal_services",
              "administration",
              "social_services",
              "science",
              "manufacturing",
              "public_safety",
              "marketing",
              "sales",
              "support",
              "business_analysis",
              "solutions_engineering",
              "developer_relations",
              "technical_writing",
              "recruiting",
              "hr",
              "finance",
              "legal",
              "operations",
              "customer_success",
              "other",
              "management"
            ]
          }
        }
      },
      "job.category_exclude": {
        "name": "category_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `category` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "software_engineering",
              "backend",
              "frontend",
              "fullstack",
              "mobile",
              "devops",
              "sre",
              "network_engineering",
              "system_administration",
              "telecommunications_engineering",
              "it_support",
              "data_engineering",
              "data_science",
              "data_analytics",
              "ml_ai",
              "ai_engineering",
              "qa",
              "security",
              "hardware",
              "embedded",
              "blockchain",
              "architecture",
              "design",
              "creative",
              "engineering_design",
              "industrial_engineering",
              "occupational_safety",
              "product",
              "project_management",
              "healthcare",
              "skilled_trades",
              "retail",
              "hospitality",
              "logistics",
              "education",
              "personal_services",
              "administration",
              "social_services",
              "science",
              "manufacturing",
              "public_safety",
              "marketing",
              "sales",
              "support",
              "business_analysis",
              "solutions_engineering",
              "developer_relations",
              "technical_writing",
              "recruiting",
              "hr",
              "finance",
              "legal",
              "operations",
              "customer_success",
              "other",
              "management"
            ]
          }
        }
      },
      "job.category_mode": {
        "name": "category_mode",
        "in": "query",
        "description": "`and` requires every listed `category` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.ai_archetype": {
        "name": "ai_archetype",
        "in": "query",
        "description": "AI Specialization.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "rag_app_builder",
              "agent_builder",
              "cloud_ml_platform_engineer",
              "ml_trainer_researcher",
              "fullstack_ai_engineer",
              "devops_infra_engineer"
            ]
          }
        }
      },
      "job.ai_archetype_exclude": {
        "name": "ai_archetype_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `ai_archetype` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "rag_app_builder",
              "agent_builder",
              "cloud_ml_platform_engineer",
              "ml_trainer_researcher",
              "fullstack_ai_engineer",
              "devops_infra_engineer"
            ]
          }
        }
      },
      "job.ai_archetype_mode": {
        "name": "ai_archetype_mode",
        "in": "query",
        "description": "`and` requires every listed `ai_archetype` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.seniority": {
        "name": "seniority",
        "in": "query",
        "description": "Seniority.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "intern",
              "junior",
              "middle",
              "senior",
              "lead",
              "staff",
              "principal",
              "c_level"
            ]
          }
        }
      },
      "job.seniority_exclude": {
        "name": "seniority_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `seniority` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "intern",
              "junior",
              "middle",
              "senior",
              "lead",
              "staff",
              "principal",
              "c_level"
            ]
          }
        }
      },
      "job.seniority_mode": {
        "name": "seniority_mode",
        "in": "query",
        "description": "`and` requires every listed `seniority` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.role_type": {
        "name": "role_type",
        "in": "query",
        "description": "Role type: the title names a people-management role. One value only: carrying nothing means no management marker was found, NOT that the posting is individual-contributor work, so role_type_exclude means \"no marker\", not \"IC\".",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "people_manager"
            ]
          }
        }
      },
      "job.role_type_exclude": {
        "name": "role_type_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `role_type` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "people_manager"
            ]
          }
        }
      },
      "job.role_type_mode": {
        "name": "role_type_mode",
        "in": "query",
        "description": "`and` requires every listed `role_type` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.skills": {
        "name": "skills",
        "in": "query",
        "description": "Skills: Open vocabulary — call /jobs/facets for live values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.skills_exclude": {
        "name": "skills_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `skills` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.skills_mode": {
        "name": "skills_mode",
        "in": "query",
        "description": "`and` requires every listed `skills` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.domains": {
        "name": "domains",
        "in": "query",
        "description": "Industry.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "fintech",
              "crypto",
              "ecommerce",
              "gambling",
              "gamedev",
              "media",
              "travel",
              "healthcare",
              "edtech",
              "govtech",
              "devtools",
              "cybersecurity",
              "ai",
              "hrtech",
              "adtech",
              "proptech",
              "logistics",
              "mobility",
              "climatetech",
              "other"
            ]
          }
        }
      },
      "job.domains_exclude": {
        "name": "domains_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `domains` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "fintech",
              "crypto",
              "ecommerce",
              "gambling",
              "gamedev",
              "media",
              "travel",
              "healthcare",
              "edtech",
              "govtech",
              "devtools",
              "cybersecurity",
              "ai",
              "hrtech",
              "adtech",
              "proptech",
              "logistics",
              "mobility",
              "climatetech",
              "other"
            ]
          }
        }
      },
      "job.domains_mode": {
        "name": "domains_mode",
        "in": "query",
        "description": "`and` requires every listed `domains` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.company_type": {
        "name": "company_type",
        "in": "query",
        "description": "Company type.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "product",
              "startup",
              "outsource",
              "outstaff",
              "agency",
              "inhouse",
              "government"
            ]
          }
        }
      },
      "job.company_type_exclude": {
        "name": "company_type_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `company_type` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "product",
              "startup",
              "outsource",
              "outstaff",
              "agency",
              "inhouse",
              "government"
            ]
          }
        }
      },
      "job.company_type_mode": {
        "name": "company_type_mode",
        "in": "query",
        "description": "`and` requires every listed `company_type` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.countries": {
        "name": "countries",
        "in": "query",
        "description": "Countries: Open vocabulary — call /jobs/facets for live values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.countries_exclude": {
        "name": "countries_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `countries` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.cities": {
        "name": "cities",
        "in": "query",
        "description": "City: Open vocabulary — call /jobs/facets for live values. Recognized dictionary aliases such as München and Köln resolve to their canonical city names..",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.cities_exclude": {
        "name": "cities_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `cities` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.metros": {
        "name": "metros",
        "in": "query",
        "description": "Metro area: Open vocabulary — call /jobs/facets for live values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.metros_exclude": {
        "name": "metros_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `metros` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.relocation": {
        "name": "relocation",
        "in": "query",
        "description": "Relocation.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "not_supported",
              "supported",
              "required"
            ]
          }
        }
      },
      "job.relocation_exclude": {
        "name": "relocation_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `relocation` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "not_supported",
              "supported",
              "required"
            ]
          }
        }
      },
      "job.relocation_mode": {
        "name": "relocation_mode",
        "in": "query",
        "description": "`and` requires every listed `relocation` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.employment_type": {
        "name": "employment_type",
        "in": "query",
        "description": "Employment.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "full_time",
              "part_time",
              "contract",
              "internship",
              "fellowship"
            ]
          }
        }
      },
      "job.employment_type_exclude": {
        "name": "employment_type_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `employment_type` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "full_time",
              "part_time",
              "contract",
              "internship",
              "fellowship"
            ]
          }
        }
      },
      "job.employment_type_mode": {
        "name": "employment_type_mode",
        "in": "query",
        "description": "`and` requires every listed `employment_type` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.engagement": {
        "name": "engagement",
        "in": "query",
        "description": "Contract terms: employee or own business, in each market's own term (UK IR35, US W-2/1099/C2C, Polish B2B and umowy, Brazilian CLT/PJ, Russian ТК/ГПХ/самозанятость/ИП, German, Dutch, French, Spanish and Argentine freelance statuses), as the title, the description or a source's own contract-type field states it; a posting offering several carries each, one that does not say carries none. Separate from employment_type.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "ir35_outside",
              "ir35_inside",
              "w2",
              "1099",
              "c2c",
              "contract_to_hire",
              "b2b",
              "uop",
              "umowa_zlecenie",
              "umowa_o_dzielo",
              "clt",
              "pj",
              "tk",
              "gph",
              "samozanyaty",
              "ip",
              "freiberuflich",
              "arbeitnehmerueberlassung",
              "zzp",
              "auto_entrepreneur",
              "portage_salarial",
              "autonomo",
              "monotributo"
            ]
          }
        }
      },
      "job.engagement_exclude": {
        "name": "engagement_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `engagement` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "ir35_outside",
              "ir35_inside",
              "w2",
              "1099",
              "c2c",
              "contract_to_hire",
              "b2b",
              "uop",
              "umowa_zlecenie",
              "umowa_o_dzielo",
              "clt",
              "pj",
              "tk",
              "gph",
              "samozanyaty",
              "ip",
              "freiberuflich",
              "arbeitnehmerueberlassung",
              "zzp",
              "auto_entrepreneur",
              "portage_salarial",
              "autonomo",
              "monotributo"
            ]
          }
        }
      },
      "job.engagement_mode": {
        "name": "engagement_mode",
        "in": "query",
        "description": "`and` requires every listed `engagement` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.english_level": {
        "name": "english_level",
        "in": "query",
        "description": "English.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "none",
              "a1",
              "a2",
              "b1",
              "b2",
              "c1",
              "c2",
              "native"
            ]
          }
        }
      },
      "job.english_level_exclude": {
        "name": "english_level_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `english_level` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "none",
              "a1",
              "a2",
              "b1",
              "b2",
              "c1",
              "c2",
              "native"
            ]
          }
        }
      },
      "job.english_level_mode": {
        "name": "english_level_mode",
        "in": "query",
        "description": "`and` requires every listed `english_level` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.posting_language": {
        "name": "posting_language",
        "in": "query",
        "description": "Job language: Open vocabulary — call /jobs/facets for live values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.posting_language_exclude": {
        "name": "posting_language_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `posting_language` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.posting_language_mode": {
        "name": "posting_language_mode",
        "in": "query",
        "description": "`and` requires every listed `posting_language` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.reality": {
        "name": "reality",
        "in": "query",
        "description": "Posting reality.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "fresh",
              "stale",
              "likely-evergreen"
            ]
          }
        }
      },
      "job.reality_exclude": {
        "name": "reality_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `reality` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "fresh",
              "stale",
              "likely-evergreen"
            ]
          }
        }
      },
      "job.reality_mode": {
        "name": "reality_mode",
        "in": "query",
        "description": "`and` requires every listed `reality` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.salary_currency": {
        "name": "salary_currency",
        "in": "query",
        "description": "Currency: USD, EUR, GBP, RUB.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.salary_currency_exclude": {
        "name": "salary_currency_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `salary_currency` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.salary_currency_mode": {
        "name": "salary_currency_mode",
        "in": "query",
        "description": "`and` requires every listed `salary_currency` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.perks": {
        "name": "perks",
        "in": "query",
        "description": "Perks mentioned: matched from the description; a posting without one does not mention it, which is not the same as not offering it.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "generous_pto",
              "four_day_week",
              "401k_match",
              "parental_leave",
              "retirement_plan",
              "tuition_reimbursement",
              "unlimited_pto",
              "health_insurance",
              "mental_health",
              "learning_budget",
              "home_office_stipend",
              "sabbatical",
              "sign_on_bonus"
            ]
          }
        }
      },
      "job.perks_exclude": {
        "name": "perks_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `perks` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "generous_pto",
              "four_day_week",
              "401k_match",
              "parental_leave",
              "retirement_plan",
              "tuition_reimbursement",
              "unlimited_pto",
              "health_insurance",
              "mental_health",
              "learning_budget",
              "home_office_stipend",
              "sabbatical",
              "sign_on_bonus"
            ]
          }
        }
      },
      "job.perks_mode": {
        "name": "perks_mode",
        "in": "query",
        "description": "`and` requires every listed `perks` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.equity": {
        "name": "equity",
        "in": "query",
        "description": "Equity: not_stated means none was read, not that the job offers no equity.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "salary_and_equity",
              "equity_only",
              "not_stated"
            ]
          }
        }
      },
      "job.equity_exclude": {
        "name": "equity_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `equity` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "salary_and_equity",
              "equity_only",
              "not_stated"
            ]
          }
        }
      },
      "job.equity_mode": {
        "name": "equity_mode",
        "in": "query",
        "description": "`and` requires every listed `equity` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.company_slug": {
        "name": "company_slug",
        "in": "query",
        "description": "Company: Open vocabulary — call /jobs/facets for live values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.company_slug_exclude": {
        "name": "company_slug_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `company_slug` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.company_slug_mode": {
        "name": "company_slug_mode",
        "in": "query",
        "description": "`and` requires every listed `company_slug` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.source_type": {
        "name": "source_type",
        "in": "query",
        "description": "Source type.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "ats",
              "company",
              "aggregator",
              "social"
            ]
          }
        }
      },
      "job.source_type_exclude": {
        "name": "source_type_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `source_type` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "ats",
              "company",
              "aggregator",
              "social"
            ]
          }
        }
      },
      "job.source_type_mode": {
        "name": "source_type_mode",
        "in": "query",
        "description": "`and` requires every listed `source_type` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.clearance_levels": {
        "name": "clearance_levels",
        "in": "query",
        "description": "Clearance level: none = no detected clearance requirement (the same postings as requires_clearance=false); other = a non-US scheme (UK SC/DV, AU NV1, NATO) or a clearance stated with no level; interim is stated beside a level, not instead of one.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "none",
              "confidential",
              "secret",
              "top_secret",
              "ts_sci",
              "public_trust",
              "interim",
              "other"
            ]
          }
        }
      },
      "job.clearance_levels_exclude": {
        "name": "clearance_levels_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `clearance_levels` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "none",
              "confidential",
              "secret",
              "top_secret",
              "ts_sci",
              "public_trust",
              "interim",
              "other"
            ]
          }
        }
      },
      "job.clearance_levels_mode": {
        "name": "clearance_levels_mode",
        "in": "query",
        "description": "`and` requires every listed `clearance_levels` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.source": {
        "name": "source",
        "in": "query",
        "description": "Source: Open vocabulary — call /jobs/facets for live values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.source_exclude": {
        "name": "source_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `source` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "job.source_mode": {
        "name": "source_mode",
        "in": "query",
        "description": "`and` requires every listed `source` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.company_size": {
        "name": "company_size",
        "in": "query",
        "description": "Company size.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "1-10",
              "11-50",
              "51-200",
              "201-500",
              "501-1000",
              "1000+"
            ]
          }
        }
      },
      "job.company_size_exclude": {
        "name": "company_size_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `company_size` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "1-10",
              "11-50",
              "51-200",
              "201-500",
              "501-1000",
              "1000+"
            ]
          }
        }
      },
      "job.company_size_mode": {
        "name": "company_size_mode",
        "in": "query",
        "description": "`and` requires every listed `company_size` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.education_level": {
        "name": "education_level",
        "in": "query",
        "description": "Education level.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "none",
              "bachelor",
              "master",
              "phd"
            ]
          }
        }
      },
      "job.education_level_exclude": {
        "name": "education_level_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `education_level` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "none",
              "bachelor",
              "master",
              "phd"
            ]
          }
        }
      },
      "job.education_level_mode": {
        "name": "education_level_mode",
        "in": "query",
        "description": "`and` requires every listed `education_level` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.salary_period": {
        "name": "salary_period",
        "in": "query",
        "description": "Salary period.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "year",
              "month",
              "day",
              "hour"
            ]
          }
        }
      },
      "job.salary_period_exclude": {
        "name": "salary_period_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `salary_period` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "year",
              "month",
              "day",
              "hour"
            ]
          }
        }
      },
      "job.salary_period_mode": {
        "name": "salary_period_mode",
        "in": "query",
        "description": "`and` requires every listed `salary_period` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.is_tech": {
        "name": "is_tech",
        "in": "query",
        "description": "Technical role.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "tech",
              "non_tech"
            ]
          }
        }
      },
      "job.is_tech_exclude": {
        "name": "is_tech_exclude",
        "in": "query",
        "description": "Leaves out postings matching any of these `is_tech` values.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "tech",
              "non_tech"
            ]
          }
        }
      },
      "job.is_tech_mode": {
        "name": "is_tech_mode",
        "in": "query",
        "description": "`and` requires every listed `is_tech` value instead of any.",
        "schema": {
          "type": "string",
          "enum": [
            "and"
          ]
        }
      },
      "job.visa_sponsorship": {
        "name": "visa_sponsorship",
        "in": "query",
        "description": "Visa sponsorship: true, false.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.requires_clearance": {
        "name": "requires_clearance",
        "in": "query",
        "description": "Security clearance required: true, false.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.via_recruiter": {
        "name": "via_recruiter",
        "in": "query",
        "description": "Posting says a recruiter publishes it for a client: true — the description says so; false — every posting not marked, including recruiter posts that never say so.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.former_employers": {
        "name": "former_employers",
        "in": "query",
        "description": "Hiring again: companies you have worked at and left: true — signed in only, read from your experience bank; a name that does not resolve to exactly one company is left out. Anonymous, it is reported in meta.ignored_params. `/jobs/facets` never applies this filter, so its counts ignore it even for signed-in callers.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.watchlist": {
        "name": "watchlist",
        "in": "query",
        "description": "Your watchlist: companies you follow: true — signed in only; an empty watchlist matches nothing. Anonymous, it is reported in meta.ignored_params. Kept in a saved search, so `watchlist=true` is the alert for new postings at the companies you follow. `/jobs/facets` never applies this filter, so its counts ignore it.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.salary_min": {
        "name": "salary_min",
        "in": "query",
        "description": "Minimum salary: integer — jobs whose minimum salary is at least this (pair with salary_currency).",
        "schema": {
          "type": "integer"
        }
      },
      "job.salary_max": {
        "name": "salary_max",
        "in": "query",
        "description": "Maximum salary: integer — jobs whose maximum salary is at most this (pair with salary_currency).",
        "schema": {
          "type": "integer"
        }
      },
      "job.experience_years_min": {
        "name": "experience_years_min",
        "in": "query",
        "description": "Minimum experience: integer — jobs requiring at least this many years.",
        "schema": {
          "type": "integer"
        }
      },
      "job.experience_years_max": {
        "name": "experience_years_max",
        "in": "query",
        "description": "Maximum experience: integer — jobs requiring at most this many years, the same figure experience_years_min bounds from below. Use 0 for jobs stating no prior experience is required. Either bound excludes jobs that state no requirement at all, unless experience_include_unspecified is set.",
        "schema": {
          "type": "integer"
        }
      },
      "job.experience_include_unspecified": {
        "name": "experience_include_unspecified",
        "in": "query",
        "description": "Include unstated experience: true — with either experience bound, also keep the jobs that state no experience requirement (most of the catalogue). Has no effect without a bound.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.experience_only_seniority_unspecified": {
        "name": "experience_only_seniority_unspecified",
        "in": "query",
        "description": "Experience only without a level: true — apply either experience bound only to the jobs that carry no seniority level; a job with a level passes the bound whatever it states. With seniority and seniority_include_unspecified this reads \"one of these levels, or no level and within the bound\". Has no effect without a bound.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.seniority_include_unspecified": {
        "name": "seniority_include_unspecified",
        "in": "query",
        "description": "Include unstated seniority: true — with seniority, also keep the jobs that carry no seniority level (most of the catalogue). Has no effect without an included seniority.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.posted_within_days": {
        "name": "posted_within_days",
        "in": "query",
        "description": "Posted within: integer — jobs whose SOURCE states a posting date in the last N days. Some boards restate that date on every crawl, so a job open for months can satisfy a narrow bound here; open_within_days is the one that cannot be rewritten from outside.",
        "schema": {
          "type": "integer"
        }
      },
      "job.open_within_days": {
        "name": "open_within_days",
        "in": "query",
        "description": "Open within: integer — jobs first recorded by freehire in the last N days, i.e. how long the posting has been in the catalogue regardless of the date its source states. Independent of posted_within_days; both may be set and they narrow together.",
        "schema": {
          "type": "integer"
        }
      },
      "job.apply_questions_max": {
        "name": "apply_questions_max",
        "in": "query",
        "description": "Application questions: integer ≥ 0 — jobs whose application form requires at most N questions beyond name, contact details and CV (3 = the \"short form\" filter). Jobs with no form freehire could read are excluded: unknown is not short.",
        "schema": {
          "type": "integer"
        }
      },
      "job.auto_apply_available": {
        "name": "auto_apply_available",
        "in": "query",
        "description": "Auto-apply can attempt it: true — only postings whose ATS freehire auto-apply can currently attempt to fill and submit for; a provider-eligibility signal, never a guarantee the submission succeeds.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.work_mode_remote_anywhere": {
        "name": "work_mode_remote_anywhere",
        "in": "query",
        "description": "Remote from anywhere, other modes at home: true — with `remote` and a physical work_mode both selected and a geography facet set, reads \"remote anywhere, OR hybrid/onsite within the geography\" instead of ANDing them. Otherwise, or with work_mode_mode=and, it changes nothing.",
        "schema": {
          "type": "boolean"
        }
      },
      "job.work_mode_remote_regions": {
        "name": "work_mode_remote_regions",
        "in": "query",
        "description": "Remote arm: regions: Region values, as regions — bound the remote arm of work_mode_remote_anywhere. Read only while it is in force.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "global",
              "north_america",
              "latam",
              "eu",
              "uk",
              "mena",
              "africa",
              "apac",
              "cis",
              "none"
            ]
          }
        }
      },
      "job.work_mode_remote_countries": {
        "name": "work_mode_remote_countries",
        "in": "query",
        "description": "Remote arm: countries: ISO 3166-1 alpha-2 codes, as countries — bound the remote arm of work_mode_remote_anywhere, ORed with work_mode_remote_regions. Read only while it is in force.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.collections": {
        "name": "collections",
        "in": "query",
        "description": "Collection: yc, techstars, a16z-portfolio, a16z-speedrun, sequoia, accel, greylock, usv, bond, lightspeed, index-ventures, softbank-vision-fund, founders-fund, european, ai, mag7, bigtech, unicorn, fortune500, eastern-roots, indian-roots, ai-native, uk-skilled-worker-sponsor, nl-recognised-sponsor, us-h1b-sponsor, ca-lmia-employer, ie-permit-employer, dk-fast-track-company.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.regions": {
        "name": "regions",
        "in": "query",
        "description": "Region: global, north_america, latam, eu, uk, mena, africa, apac, cis.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.remote_regions": {
        "name": "remote_regions",
        "in": "query",
        "description": "Remote hiring: global, north_america, latam, eu, uk, mena, africa, apac, cis.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.countries": {
        "name": "countries",
        "in": "query",
        "description": "Country: e.g. af, ax, al, dz, as.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.industries": {
        "name": "industries",
        "in": "query",
        "description": "Industry: e.g. accounting, adtech, aerospace, agriculture, ai.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.company_type": {
        "name": "company_type",
        "in": "query",
        "description": "Company type: product, startup, outsource, outstaff, agency, inhouse, government.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.company_size": {
        "name": "company_size",
        "in": "query",
        "description": "Company size: 1-10, 11-50, 51-200, 201-500, 501-1000, 1000+.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.maturity": {
        "name": "maturity",
        "in": "query",
        "description": "Company stage: startup, scaleup, enterprise, government.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.yc_status": {
        "name": "yc_status",
        "in": "query",
        "description": "YC status: Active, Acquired, Public, Inactive.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.yc_stage": {
        "name": "yc_stage",
        "in": "query",
        "description": "YC stage: Early, Growth.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.yc_flags": {
        "name": "yc_flags",
        "in": "query",
        "description": "YC highlights: top_company, hiring.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.yc_batch": {
        "name": "yc_batch",
        "in": "query",
        "description": "YC batch: e.g. Winter 2027, Spring 2027, Summer 2027, Fall 2027, Winter 2026.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "company.domains": {
        "name": "domains",
        "in": "query",
        "description": "Job-derived domains, aggregated per company: fintech, crypto, ecommerce, gambling, gamedev, media, travel, healthcare, edtech, govtech, devtools, cybersecurity, ai, hrtech, adtech, proptech, logistics, mobility, climatetech, other.",
        "style": "form",
        "explode": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "schemas": {
      "AgentJobSearchMeta": {
        "type": "object",
        "required": [
          "total",
          "limit",
          "offset"
        ],
        "properties": {
          "total": {
            "type": "integer",
            "format": "int64"
          },
          "limit": {
            "type": "integer",
            "format": "int64"
          },
          "offset": {
            "type": "integer",
            "format": "int64"
          },
          "ignored_params": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IgnoredParam"
            },
            "description": "Absent when every param was read."
          },
          "ignored_values": {
            "$ref": "#/components/schemas/IgnoredValues"
          },
          "total_is_lower_bound": {
            "type": "boolean",
            "description": "True when `total` counts only what was read, not the whole match."
          },
          "semantic": {
            "type": "string",
            "description": "\"unavailable\" when `semantic=true` was asked and the request was answered by keywords."
          }
        }
      },
      "CityMatch": {
        "type": "object",
        "required": [
          "value",
          "country"
        ],
        "properties": {
          "value": {
            "type": "string",
            "description": "Canonical city name — pass it verbatim to the `cities` facet, which matches nothing on a near miss."
          },
          "country": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2, lower case."
          }
        }
      },
      "CompanyDetail": {
        "type": "object",
        "required": [
          "slug",
          "name"
        ],
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "job_count": {
            "type": "integer"
          },
          "tagline": {
            "type": "string",
            "nullable": true
          },
          "company_info": {
            "description": "Homepage, description, and other profile fields where known.",
            "type": "object",
            "additionalProperties": {},
            "nullable": true
          },
          "industries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "collections": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "remote_regions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Regions the company hires remotely in, derived from its open postings."
          },
          "company_types": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "company_sizes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "hq_country": {
            "type": "string",
            "nullable": true
          },
          "year_founded": {
            "type": "integer",
            "nullable": true
          },
          "employee_count": {
            "type": "integer",
            "nullable": true
          },
          "organization_type": {
            "type": "string",
            "nullable": true
          },
          "maturity": {
            "type": "string",
            "nullable": true
          },
          "yc_batch": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "yc_status": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "yc_stage": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "yc_flags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "feedback_count": {
            "type": "integer"
          },
          "feedback_rating_avg": {
            "type": "number",
            "nullable": true
          },
          "upvote_count": {
            "type": "integer"
          },
          "downvote_count": {
            "type": "integer"
          },
          "my_vote": {
            "description": "The calling user's vote; 0 or null without a signed-in caller.",
            "type": "integer",
            "nullable": true
          }
        },
        "description": "The company summary plus the profile fields served only on the detail endpoint."
      },
      "CompanyListItem": {
        "type": "object",
        "required": [
          "slug",
          "name",
          "job_count",
          "tagline",
          "industries",
          "hq_country",
          "collections",
          "feedback_count",
          "feedback_rating_avg"
        ],
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "job_count": {
            "type": "integer",
            "format": "int64"
          },
          "tagline": {
            "type": "string",
            "nullable": true
          },
          "industries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "hq_country": {
            "type": "string",
            "nullable": true
          },
          "collections": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Curated company tags; the catalogue card renders the backer marks from these."
          },
          "feedback_count": {
            "type": "integer",
            "format": "int64"
          },
          "feedback_rating_avg": {
            "description": "Null until a review counts.",
            "type": "number",
            "format": "float",
            "nullable": true
          },
          "ai_interview_reports": {
            "type": "integer",
            "format": "int64",
            "description": "How many people reported an AI interviewer. Absent at zero, so a badge never shows a bare 0."
          }
        },
        "description": "A row of the catalogue: the company, its open-job count and a few company-info facts for the card."
      },
      "CompanyPage": {
        "type": "object",
        "properties": {
          "company": {
            "$ref": "#/components/schemas/CompanyDetail"
          },
          "jobs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Job"
            }
          },
          "referral_available": {
            "type": "boolean",
            "description": "Whether an employee referral offer exists for this company."
          },
          "parent": {
            "$ref": "#/components/schemas/CompanyRef"
          },
          "subsidiaries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyRef"
            },
            "description": "Companies this one owns. Each is a separate employer with its own jobs. Omitted when there are none."
          }
        },
        "description": "The `/companies/{slug}` answer: the company and a page of its open jobs."
      },
      "CompanyRef": {
        "type": "object",
        "required": [
          "slug",
          "name",
          "job_count"
        ],
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "job_count": {
            "type": "integer",
            "description": "Open jobs the related company has."
          }
        },
        "description": "A related company: the parent that owns this one, or a subsidiary it owns. It is a\nseparate company with its own page and jobs, not another name for this one."
      },
      "FacetStatRange": {
        "type": "object",
        "required": [
          "min",
          "max"
        ],
        "properties": {
          "min": {
            "type": "number",
            "format": "double"
          },
          "max": {
            "type": "number",
            "format": "double"
          }
        },
        "description": "The smallest and largest value of one continuous facet among the matching postings."
      },
      "IgnoredMeta": {
        "type": "object",
        "properties": {
          "ignored_params": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IgnoredParam"
            }
          },
          "ignored_values": {
            "$ref": "#/components/schemas/IgnoredValues"
          }
        },
        "description": "The meta of a single-item answer, sent only to carry a warning."
      },
      "IgnoredParam": {
        "type": "object",
        "required": [
          "param"
        ],
        "properties": {
          "param": {
            "type": "string"
          },
          "did_you_mean": {
            "type": "string"
          }
        },
        "description": "A query param the endpoint did not read: unknown, or known but unreadable\n(`min_years=lots`). Either way the answer is wider than the caller asked for."
      },
      "IgnoredValues": {
        "type": "object",
        "additionalProperties": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "description": "Present only when a closed-vocabulary facet (or its `_exclude` form) carried a value\noutside its vocabulary — keyed by the parameter as sent, each listing the unknown values.\nOn a facet the value is still applied and matches no posting: alone it empties the\nanswer, beside other values it adds nothing to their OR, in `_exclude` it excludes\nnothing. A boolean or modifier param reads it its own way (`requires_clearance=flase`\nreads as true, `visa_sponsorship=yes` filters nothing), so the answer may be wider."
      },
      "Job": {
        "type": "object",
        "required": [
          "public_slug",
          "title",
          "company"
        ],
        "properties": {
          "public_slug": {
            "type": "string",
            "description": "Stable public identifier. The freehire page is https://freehire.me/jobs/{public_slug}."
          },
          "title": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "company_slug": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "description": "The employer's own application URL. This is where an applicant goes. Empty when\n`direct_apply` is true: that vacancy has no page elsewhere."
          },
          "direct_apply": {
            "type": "boolean",
            "description": "True for a vacancy its employer published on freehire that takes applications only on\nits freehire page (`https://freehire.me/jobs/{slug}`). Absent for every other posting."
          },
          "location": {
            "type": "string",
            "description": "The posting's own location string, verbatim and unnormalized. Filter on the geography facets instead."
          },
          "source": {
            "type": "string",
            "description": "Origin slug — the ATS or board this posting was crawled from."
          },
          "external_id": {
            "type": "string",
            "description": "The source's own identifier for the posting."
          },
          "application_deadline": {
            "type": "string",
            "format": "date",
            "description": "Source-stated last application day, inclusive. Absent when the source states no deadline."
          },
          "team": {
            "type": "string",
            "description": "The department or team the posting's ATS files it under, verbatim (Greenhouse, Lever and\nAshby state one). Absent when the source states none; not a taxonomy, so values differ\nbetween employers."
          },
          "manually_added": {
            "type": "boolean",
            "description": "True for a hand-curated posting rather than an automated crawl."
          },
          "description": {
            "type": "string",
            "description": "Stored verbatim HTML by default. `searchJobs` serves a truncated preview;\n`agentSearchJobs` and `getJob` serve the full body, and `agentSearchJobs` can convert\nit via `description_format`."
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "metros": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "work_mode": {
            "type": "string",
            "enum": [
              "remote",
              "hybrid",
              "onsite"
            ],
            "description": "Absent when the posting's format could not be resolved."
          },
          "skills": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "collections": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Curated collection slugs of the posting's company."
          },
          "is_tech": {
            "type": "string",
            "enum": [
              "tech",
              "non_tech"
            ],
            "description": "Absent when unknown."
          },
          "requires_clearance": {
            "type": "boolean",
            "description": "Present and `true` only when the posting states a government security-clearance\nrequirement. Absent otherwise — there is no `false`, because \"no requirement was\ndetected\" is not the same claim as \"this posting needs no clearance\"."
          },
          "via_recruiter": {
            "type": "boolean",
            "description": "Present and `true` only when the posting states that it is published by an\nintermediary on a client's behalf. Absent otherwise — a recruiter who never says so is\nnot detected, so absence does not mean the employer posted it."
          },
          "equity": {
            "type": "string",
            "enum": [
              "salary_and_equity",
              "equity_only"
            ],
            "description": "What the posting states about equity compensation: `salary_and_equity` (offered beside\ncash pay) or `equity_only` (equity is the whole pay). Absent when the posting states\nneither — \"not stated\", not \"no equity\"."
          },
          "clearance_levels": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "confidential",
                "secret",
                "top_secret",
                "ts_sci",
                "public_trust",
                "interim",
                "other"
              ]
            },
            "description": "The security-clearance levels the posting states. Present exactly when\n`requires_clearance` is, absent otherwise. `other` is a non-US scheme or a clearance\nstated with no level."
          },
          "perks": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Benefits the description states it offers (see the `perks` filter for the\nvocabulary). Empty when it names none of them — not a claim that the job offers none."
          },
          "engagement": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The legal terms the posting states it engages its worker on (see the `engagement`\nfilter for the vocabulary). Empty when it does not say."
          },
          "auto_apply_available": {
            "type": "boolean",
            "description": "Present and `true` only when the posting's ATS provider is one freehire's auto-apply\nfeature can currently attempt to fill and submit for. Absent otherwise — a best-effort\nprovider-eligibility signal, never a guarantee of successful submission."
          },
          "apply_questions": {
            "type": "integer",
            "minimum": 0,
            "description": "How many questions the posting's application form REQUIRES beyond the standard fields\nevery form asks for (name, contact details, CV, cover letter), counted from the form\nfreehire captured from the employer's ATS. Optional questions, the equal-opportunity\nsurvey and consent boxes are not counted. `0` means no REQUIRED question beyond the\nbasics. Absent when freehire holds no form for the posting — \"not known\", never\n\"long\". Served by search hits and the job detail; a list read straight from the\ndatabase may omit it."
          },
          "posted_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "created_at": {
            "description": "When freehire first saw the posting.",
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "last_seen_at": {
            "description": "When a re-crawl last confirmed the posting was still live.",
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "closed_at": {
            "description": "Non-null once the posting is no longer open. Only `getJob` ever serves such a row.",
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "enrichment": {
            "$ref": "#/components/schemas/JobEnrichment"
          },
          "enriched_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "enrichment_version": {
            "description": "Bumped when the enrichment contract changes — use it to detect re-enriched rows.",
            "type": "integer",
            "nullable": true
          },
          "my_vote": {
            "description": "The calling user's vote; 0 or null without a signed-in caller.",
            "type": "integer",
            "nullable": true
          },
          "reality": {
            "$ref": "#/components/schemas/JobReality"
          },
          "ghost": {
            "$ref": "#/components/schemas/JobGhost"
          },
          "view_count": {
            "type": "integer"
          },
          "applied_count": {
            "type": "integer"
          },
          "upvote_count": {
            "type": "integer"
          },
          "downvote_count": {
            "type": "integer"
          }
        },
        "description": "One posting, as every job endpoint serves it."
      },
      "JobEnrichment": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "string",
            "description": "The one synthesized field — a 1-2 sentence synopsis, always present on an enriched posting."
          },
          "employment_type": {
            "type": "string"
          },
          "relocation": {
            "type": "string"
          },
          "visa_sponsorship": {
            "type": "boolean"
          },
          "timezone_note": {
            "type": "string"
          },
          "salary_min": {
            "type": "integer"
          },
          "salary_max": {
            "type": "integer"
          },
          "salary_currency": {
            "type": "string"
          },
          "salary_period": {
            "type": "string"
          },
          "seniority": {
            "type": "string"
          },
          "experience_years_min": {
            "type": "integer"
          },
          "english_level": {
            "type": "string"
          },
          "education_level": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "posting_language": {
            "type": "string"
          },
          "company_type": {
            "type": "string"
          },
          "company_size": {
            "type": "string"
          }
        },
        "description": "Model-extracted attributes, every field omitted when the posting did not state it.\n`work_mode`, `regions`, `countries`, `cities` and `skills` are deliberately NOT here —\nthose are served top-level from the deterministic dictionaries, and the model's own\nvalues for them are not published."
      },
      "JobFacetCounts": {
        "type": "object",
        "required": [
          "total",
          "facets",
          "stats"
        ],
        "properties": {
          "total": {
            "type": "integer"
          },
          "facets": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "type": "integer"
              }
            },
            "description": "Facet name to a map of value to matching-posting count."
          },
          "stats": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/FacetStatRange"
            },
            "description": "Numeric ranges (min/max) for the continuous facets — `salary_min`, `salary_max`, `experience_years_min`."
          },
          "companies_total": {
            "type": "integer",
            "description": "Present only when `facets=` names `company_slug`: the exact number of distinct\ncompanies among the matching postings."
          },
          "top_companies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TopCompany"
            },
            "maxItems": 50,
            "description": "Present only when `facets=` names `company_slug`: the companies with the most matching\npostings, in descending count. Replaces a `company_slug` entry in `facets`."
          }
        },
        "description": "The `/jobs/facets` answer: posting counts per facet value under the request's filters."
      },
      "JobGhost": {
        "type": "object",
        "properties": {
          "level": {
            "type": "string",
            "description": "How strongly the evidence reads, e.g. `possible`."
          },
          "criteria": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Which criteria fired, e.g. `evergreen_posting`, `ats_absent`."
          },
          "criteria_total": {
            "type": "integer",
            "description": "How many criteria exist, so `criteria` reads as N-of-total."
          },
          "contributors": {
            "type": "integer",
            "description": "Number of independent user reports, once past the disclosure gate."
          },
          "ats_checked_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the posting was last looked for on the employer's own ATS. Present only when the `ats_absent` criterion fired."
          }
        },
        "description": "Hedged \"is anyone actually hiring for this\" verdict, raised only when evidence fires —\nmost postings carry none, so an absent value means \"no signal\", never \"verified real\".\nAttached by `searchJobs`, `getJob` and the plain jobs list. NOT attached by\n`agentSearchJobs` or `getSimilarJobs`, so its absence on those two is not evidence\neither way."
      },
      "JobReality": {
        "type": "object",
        "properties": {
          "class": {
            "type": "string",
            "enum": [
              "fresh",
              "stale",
              "likely-evergreen"
            ]
          },
          "age_days": {
            "type": "integer"
          },
          "repost_count": {
            "type": "integer",
            "description": "How many times this role has been reposted."
          },
          "mass_posting_count": {
            "type": "integer",
            "description": "How many near-identical postings the same role cluster holds."
          },
          "fake_freshness": {
            "type": "boolean",
            "description": "True when the stated posting date looks refreshed rather than real."
          }
        },
        "description": "Signals about whether the posting reflects a real, current opening."
      },
      "JobSearchMeta": {
        "type": "object",
        "required": [
          "total",
          "limit",
          "offset"
        ],
        "properties": {
          "total": {
            "type": "integer",
            "format": "int64"
          },
          "limit": {
            "type": "integer",
            "format": "int64"
          },
          "offset": {
            "type": "integer",
            "format": "int64"
          },
          "ignored_params": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IgnoredParam"
            },
            "description": "Absent when every param was read."
          },
          "ignored_values": {
            "$ref": "#/components/schemas/IgnoredValues"
          },
          "total_is_lower_bound": {
            "type": "boolean",
            "description": "True when `total` counts only what was read, not the whole match."
          }
        }
      },
      "ListMeta": {
        "type": "object",
        "required": [
          "total",
          "limit",
          "offset"
        ],
        "properties": {
          "total": {
            "type": "integer",
            "format": "int64"
          },
          "limit": {
            "type": "integer",
            "format": "int64"
          },
          "offset": {
            "type": "integer",
            "format": "int64"
          },
          "ignored_params": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IgnoredParam"
            },
            "description": "Absent when every param was read."
          },
          "ignored_values": {
            "$ref": "#/components/schemas/IgnoredValues"
          },
          "total_is_lower_bound": {
            "type": "boolean",
            "description": "True when `total` counts only what was read, not the whole match."
          }
        },
        "description": "A page of a filtered list, with what the filter dropped."
      },
      "Problem": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "code": {
            "type": "string"
          }
        },
        "description": "Every refusal, whatever its status: `{\"error\": msg}`. `code` is set only where a\nclient branches on the reason (the auth flows)."
      },
      "SuggestMeta": {
        "type": "object",
        "required": [
          "count"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "Suggestion": {
        "type": "object",
        "required": [
          "text",
          "parts",
          "jobs"
        ],
        "properties": {
          "text": {
            "type": "string",
            "description": "The whole phrase the row names — the recognised prefix plus the completion, e.g. \"Senior Software Engineer Google\"."
          },
          "parts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SuggestionPart"
            },
            "description": "Every part the row applies. Apply ALL of them: a row naming a role and a company that is\napplied as only one of the two silently discards what the caller typed."
          },
          "jobs": {
            "type": "integer",
            "format": "int64",
            "description": "Open postings behind the completion. Never zero — a suggestion that leads to an empty page is withheld."
          }
        }
      },
      "SuggestionKind": {
        "type": "string",
        "enum": [
          "title",
          "skill",
          "category",
          "company"
        ]
      },
      "SuggestionPart": {
        "type": "object",
        "required": [
          "kind",
          "text"
        ],
        "properties": {
          "kind": {
            "description": "Which vocabulary the part comes from, and so which parameter it applies to: `skill` →\n`skills`, `category` → `category`, `company` → `company_slug`. A `title` names no facet\nand is applied as `q`.",
            "allOf": [
              {
                "$ref": "#/components/schemas/SuggestionKind"
              }
            ]
          },
          "slug": {
            "type": "string",
            "description": "The facet value to apply. Absent for a `title`."
          },
          "text": {
            "type": "string",
            "description": "How this part reads on its own."
          }
        },
        "description": "One recognised piece of the query: a dictionary term, or text still being typed."
      },
      "TopCompany": {
        "type": "object",
        "required": [
          "slug",
          "name",
          "count"
        ],
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Display name; the slug when the company has none yet."
          },
          "count": {
            "type": "integer"
          }
        },
        "description": "A company and how many of the matching postings it holds."
      }
    }
  }
}
