jobbbler.com

{
  "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": "Fixed agent page size. Omit this field or pass 3 so nextCursor reaches every result.",
      "minimum": 3,
      "maximum": 3,
      "default": 3
    },
    "presentation": {
      "type": "string",
      "description": "headless keeps the current page unchanged; follow opens and synchronizes the visible search.",
      "enum": [
        "headless",
        "follow"
      ],
      "default": "headless"
    }
  }
}