{
  "type": "object",
  "properties": {
    "query": {
      "description": "Substring matched against job titles only.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "companies": {
      "description": "Exact company names from list_companies.",
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "locations": {
      "description": "Location identifiers from search_locations, e.g. city-US-CA-san_francisco.",
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "pattern": "^(?:country-[A-Za-z]{2}|state-[A-Za-z]{2}-(?=\\S)[^-\\r\\n]{1,64}|city-[A-Za-z]{2}-(?=\\S)[^-\\r\\n]{1,64}-\\S{1,80})$"
      }
    },
    "work_mode": {
      "type": "string",
      "enum": [
        "remote",
        "hybrid"
      ]
    },
    "posted_within": {
      "description": "Hard freshness filter on the publish date.",
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d"
      ]
    },
    "has_comments": {
      "description": "Only jobs with community discussion.",
      "type": "boolean"
    },
    "sort": {
      "description": "recent (default) or popular (most discussed).",
      "type": "string",
      "enum": [
        "recent",
        "popular"
      ]
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "Opaque cursor from a previous next_cursor.",
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "include_total": {
      "description": "Also compute the total match count (slower).",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "titles": {
      "description": "Title terms, any of which may match. A term matches when the title contains all its words as whole words, in any order: \"software engineer\" also matches \"Engineer, Software\". Required unless companies is given.",
      "minItems": 1,
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 60
      }
    },
    "exclude_titles": {
      "description": "Title terms that remove a posting, matched like titles, e.g. \"senior\", \"staff\", \"lead\", \"manager\".",
      "minItems": 1,
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 60
      }
    },
    "companies": {
      "description": "Exact company names from list_companies. With titles, a posting must match both.",
      "minItems": 1,
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "exclude_companies": {
      "description": "Company names to leave out, case-insensitive, e.g. the current employer.",
      "minItems": 1,
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "locations": {
      "description": "country-XX (ISO alpha-2) for a country, or state and city identifiers from search_locations. Omit for worldwide.",
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "pattern": "^(?:country-[A-Za-z]{2}|state-[A-Za-z]{2}-(?=\\S)[^-\\r\\n]{1,64}|city-[A-Za-z]{2}-(?=\\S)[^-\\r\\n]{1,64}-\\S{1,80})$"
      }
    },
    "include_anywhere": {
      "default": true,
      "description": "With locations, also keep fully remote \"Anywhere\" postings. Default true.",
      "type": "boolean"
    },
    "work_mode": {
      "description": "Only postings explicitly marked remote or hybrid.",
      "type": "string",
      "enum": [
        "remote",
        "hybrid"
      ]
    },
    "posted_within": {
      "default": "7d",
      "description": "Posting window: 24h, 7d (default) or 30d.",
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d"
      ]
    },
    "candidate_years": {
      "description": "Candidate years of professional experience; drops postings that require more than one year beyond it.",
      "type": "number",
      "minimum": 0,
      "maximum": 50
    },
    "needs_sponsorship": {
      "default": false,
      "description": "Drop postings that refuse visa sponsorship or require citizenship or a security clearance. Default false.",
      "type": "boolean"
    },
    "skills": {
      "description": "Specific skills and domain terms from the resume, as whole words or phrases. They rank results and never filter.",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40
      }
    },
    "limit": {
      "default": 15,
      "description": "Results to return, default 15.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 2147483647
        },
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048
        }
      ],
      "description": "Numeric JobYap job id, a full jobyap.com job URL, or a job page slug."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 2147483647
        },
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048
        }
      ],
      "description": "Numeric JobYap job id, a full jobyap.com job URL, or a job page slug."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Place name fragment, minimum 2 characters."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "A result id returned by search."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}