Input schema (JSON)
{
"type": "object",
"required": [
"filters"
],
"properties": {
"filters": {
"type": "object",
"properties": {
"page": {
"type": "number",
"default": 1,
"description": "Page number, starting at 1.",
"exclusiveMinimum": 0
},
"sortBy": {
"enum": [
"DateAdded",
"Salary"
],
"type": "string",
"default": "DateAdded",
"description": "DateAdded sorts newest first; Salary sorts highest salary first."
},
"language": {
"enum": [
"en",
"br",
"de",
"fr",
"ca",
"gb",
"us"
],
"type": "string",
"default": "en",
"description": "Search language context. Defaults to English. Job-title aliases are shared across languages."
},
"visaFilter": {
"type": [
"string",
"null"
],
"description": "Visa sponsorship filter: h1b or uk-skilled-worker."
},
"itemsPerPage": {
"type": "number",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Results requested per page, clamped to 1 through 50 and the remaining job quota."
},
"keywordFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required keywords. Terms are combined with AND."
},
"showHybridJobs": {
"type": "boolean",
"default": false,
"description": "Include hybrid roles."
},
"showOnsiteJobs": {
"type": "boolean",
"default": false,
"description": "Include onsite roles."
},
"showRemoteJobs": {
"type": "boolean",
"default": true,
"description": "Include remote roles."
},
"companyIdFilter": {
"type": [
"string",
"null"
],
"description": "Company identifier to restrict results to."
},
"jobTitleFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Job titles such as Software Engineer. Recognized aliases normalize to canonical titles regardless of casing or language. Unresolved ambiguous aliases remain custom search text."
},
"locationFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Eligible countries, regions, or US state names. US and UK synonyms are accepted."
},
"minSalaryFilter": {
"type": [
"number",
"null"
],
"description": "Minimum annual salary in USD."
},
"seniorityFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Allowed levels: entry-level, junior, mid, senior, expert."
},
"techStackFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Technologies used in the role, such as React or TypeScript."
},
"industriesFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Company industries to include."
},
"companySizeFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Employee ranges: 1,10; 11,50; 51,200; 201,500; 501,1000; 1001,5000; 5001,10000; 10001,."
},
"isOnLinkedInFilter": {
"enum": [
"true",
"false",
null
],
"type": [
"string",
"null"
],
"description": "String true or false for whether the role is listed on LinkedIn."
},
"hideGhostJobsFilter": {
"enum": [
"true",
"only",
null
],
"type": [
"string",
"null"
],
"description": "true hides ghost jobs; only selects them. Null disables this filter."
},
"locationCityFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "City names to include."
},
"degreeRequiredFilter": {
"enum": [
"true",
"false",
null
],
"type": [
"string",
"null"
],
"description": "String true or false for whether a degree is required."
},
"employmentTypeFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Allowed values: full-time, part-time, contract, internship."
},
"excludedKeywordFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Keywords to exclude."
},
"excludeIndustriesFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Company industries to exclude."
},
"requiredLanguagesFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required spoken-language codes to include, such as en or fr."
},
"excludeRequiredLanguagesFilters": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required spoken-language codes to exclude."
},
"showJobsWithoutSalaryWithMinSalaryFilter": {
"type": "boolean",
"default": true,
"description": "Include roles with undisclosed pay when a salary minimum is set."
}
},
"description": "Optional filters. Omitted fields use the defaults. Unrecognized values are ignored or normalized."
},
"includeJobDescription": {
"type": "boolean",
"default": false,
"description": "Include the full role description and requirements."
}
}
}