jobbbler.com

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "name": {
      "type": "string",
      "description": "A short name the person will recognize for this saved search.",
      "minLength": 1,
      "maxLength": 100
    },
    "criteria": {
      "type": "object",
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "properties": {
              "remoteOrLocations": {
                "const": true
              }
            },
            "required": [
              "remoteOrLocations"
            ]
          },
          "then": {
            "required": [
              "locations"
            ],
            "properties": {
              "locations": {
                "minItems": 1
              }
            }
          }
        }
      ],
      "properties": {
        "query": {
          "type": "string",
          "description": "Technology role, skill, or outcome to search for.",
          "maxLength": 500
        },
        "categories": {
          "type": "array",
          "description": "Technology job functions to include.",
          "maxItems": 12,
          "items": {
            "type": "string",
            "enum": [
              "software_engineering",
              "data_ai",
              "product",
              "design_research",
              "security",
              "infrastructure",
              "quality_assurance",
              "developer_relations",
              "technical_support_success",
              "technical_recruiting",
              "tech_operations_sales"
            ]
          }
        },
        "workModels": {
          "type": "array",
          "description": "Allowed work arrangements.",
          "maxItems": 4,
          "items": {
            "type": "string",
            "enum": [
              "remote",
              "hybrid",
              "onsite",
              "flexible"
            ]
          }
        },
        "employmentTypes": {
          "type": "array",
          "description": "Employment arrangements that matching roles must use.",
          "maxItems": 5,
          "items": {
            "type": "string",
            "enum": [
              "full_time",
              "part_time",
              "contract",
              "freelance",
              "internship"
            ]
          }
        },
        "seniorities": {
          "type": "array",
          "description": "Seniority levels to include.",
          "maxItems": 9,
          "items": {
            "type": "string",
            "enum": [
              "entry",
              "mid",
              "senior",
              "staff",
              "principal",
              "lead",
              "manager",
              "director",
              "executive"
            ]
          }
        },
        "locations": {
          "type": "array",
          "description": "Cities, countries, or regions to include. Do not use Remote as a place; use remoteOrLocations for requests such as ‘Berlin or remote’.",
          "maxItems": 12,
          "items": {
            "type": "string",
            "maxLength": 120
          }
        },
        "remoteOrLocations": {
          "type": "boolean",
          "description": "Match listed locations OR remote roles anywhere. Requires a location; for remote-only, use workModels=['remote']."
        },
        "skills": {
          "type": "array",
          "description": "Technology skills to prefer in match ranking.",
          "maxItems": 20,
          "items": {
            "type": "string",
            "maxLength": 120
          }
        },
        "excludeKeywords": {
          "type": "array",
          "description": "Keywords that must not appear in a matching role.",
          "maxItems": 20,
          "items": {
            "type": "string",
            "maxLength": 120
          }
        },
        "salary": {
          "type": "object",
          "description": "Annual, monthly, or hourly compensation constraint.",
          "additionalProperties": false,
          "properties": {
            "minimum": {
              "type": "number",
              "minimum": 0
            },
            "maximum": {
              "type": "number",
              "minimum": 0
            },
            "currency": {
              "type": "string",
              "pattern": "^[A-Z]{3}$"
            },
            "period": {
              "type": "string",
              "enum": [
                "hour",
                "month",
                "year"
              ]
            },
            "unknownPolicy": {
              "type": "string",
              "enum": [
                "include",
                "exclude",
                "only"
              ]
            }
          }
        },
        "postedWithinDays": {
          "type": "integer",
          "description": "Maximum age of a posting in days.",
          "minimum": 1,
          "maximum": 365
        },
        "sort": {
          "type": "string",
          "description": "Result ordering.",
          "enum": [
            "relevance",
            "newest",
            "updated_desc",
            "salary_desc",
            "salary_asc"
          ]
        },
        "cursor": {
          "type": "string",
          "description": "Opaque nextCursor from search_jobs; keep every other search criterion unchanged.",
          "maxLength": 256
        },
        "limit": {
          "type": "integer",
          "description": "Number of visible results to request.",
          "minimum": 1,
          "maximum": 50
        }
      },
      "description": "Search choices from search_jobs or the exact choices from get_search_state."
    }
  },
  "required": [
    "name",
    "criteria"
  ]
}