Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Keywords matched against title, company, location and description, e.g. \"senior product designer fintech\". All words must match.",
"type": "string",
"maxLength": 200
},
"location": {
"description": "City/state/country text to match in the posted location, e.g. \"London\", \"New York\", \"Germany\". Use \"remote\" for remote roles.",
"type": "string",
"maxLength": 80
},
"country": {
"description": "ISO-3166 alpha-2 country code, e.g. \"US\", \"GB\", \"DE\".",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"remote": {
"description": "true = only fully-remote roles; false = exclude remote roles.",
"type": "boolean"
},
"workplace": {
"description": "Workplace arrangement when the employer stated one.",
"type": "string",
"enum": [
"remote",
"hybrid",
"onsite"
]
},
"seniority": {
"description": "Seniority derived from the title.",
"type": "string",
"enum": [
"Junior / Entry",
"Mid-level",
"Senior",
"Lead / Staff",
"Principal",
"Director+"
]
},
"role_family": {
"description": "Design discipline derived from the title.",
"type": "string",
"enum": [
"Product design",
"UX / UI",
"Research",
"Content / writing",
"Design systems",
"Service design",
"Interaction",
"Design lead / mgr",
"Other design"
]
},
"company": {
"description": "Company name (substring match).",
"type": "string",
"maxLength": 80
},
"min_salary_usd": {
"description": "Only roles whose posted annual USD salary range reaches at least this figure. Only ~8% of roles post salary.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"posted_within_days": {
"description": "Only roles posted in the last N days (1–60).",
"type": "integer",
"minimum": 1,
"maximum": 60
},
"employment_type": {
"description": "e.g. \"Full-time\", \"Contract\", \"Part-time\", \"Intern\".",
"type": "string",
"maxLength": 30
},
"limit": {
"default": 20,
"description": "Results per page (1–50).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"default": 0,
"description": "Skip this many results (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}