Loading server...
{
"type": "object",
"properties": {
"employment": {
"description": "as in search_jobs",
"minItems": 1,
"maxItems": 7,
"type": "array",
"items": {
"type": "string",
"enum": [
"regular",
"contract",
"part_time",
"dispatch",
"outsourcing",
"intern",
"other"
]
}
},
"location": {
"description": "Work location contains this text, as the page writes it; width and case ignored, nothing translated (東京 does not find Tokyo)",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"salary": {
"description": "Pay in yen that reaches at_least in its period. A floor the user states (年収600万以上) is basis min, the default (the bottom of the stated range reaches it); basis max (the top reaches it, so a range that starts lower passes) only after the user agrees to see those; with too few results, say so and ask first. One stated figure is both. A posting that states its pay in another period is not compared, and most state it per month, so a yearly-only condition leaves them out. Up to four {at_least, period, basis} alternatives, any one may hold. A posting that states no salary is left out (not_stated.salary counts them; include_unstated: true lists them)",
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "object",
"properties": {
"at_least": {
"type": "integer",
"minimum": 1,
"maximum": 1000000000
},
"period": {
"type": "string",
"enum": [
"year",
"month",
"day",
"hour"
]
},
"basis": {
"type": "string",
"enum": [
"min",
"max"
]
}
},
"required": [
"at_least",
"period"
],
"additionalProperties": false
}
},
"japanese": {
"description": "Japanese requirement (either: Japanese or English will do)",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"required",
"not_required",
"either"
]
}
},
"english": {
"description": "English requirement (either: as for japanese)",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"required",
"not_required",
"either"
]
}
},
"remote": {
"description": "Remote work: any of these",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"full",
"hybrid",
"onsite"
]
}
},
"visa": {
"description": "true: postings that say they sponsor a visa (not those that say they do not or say nothing)",
"type": "boolean",
"const": true
},
"overtime": {
"description": "Fixed overtime stated as at most max_hours hours a month (0: states none)",
"type": "object",
"properties": {
"max_hours": {
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"max_hours"
],
"additionalProperties": false
},
"average_overtime": {
"description": "Overtime worked, as stated: the monthly average is at most max_hours (0: states none; a company-wide average counts (average_overtime_scope: company); ほぼなし and 少なめ are not stated)",
"type": "object",
"properties": {
"max_hours": {
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"max_hours"
],
"additionalProperties": false
},
"experience": {
"description": "The years of experience the user has in the kind of work they look for. years: names them; every result then shows experience_gap (years asked less these), nothing is left out. max_years: leaves out postings that state a larger requirement (the largest must-have counts), only when the user asks for that: a gap in years is a fact to report, never a reason to drop a posting. A posting that states no years passes (include_unstated changes nothing here): a result has extracted.experience_years, or experience_not_stated: true; tell the user which",
"type": "object",
"properties": {
"years": {
"type": "integer",
"minimum": 0,
"maximum": 50
},
"max_years": {
"type": "integer",
"minimum": 0,
"maximum": 50
}
},
"additionalProperties": false
},
"engagement": {
"description": "Who the work is done for, stated by the posting itself (explicit statements only; accuracy is not measured yet): in_house the employer's own product or service, client_site placement at a client's site (SES, 技術者派遣, 客先常駐), client_project delivery for clients (受託, SI)",
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"in_house",
"client_site",
"client_project"
]
}
},
"prefecture": {
"description": "Postings located in any of these prefectures (the normalised place): 東京都, 東京 and Tokyo are the same. A nationwide, remote or place-less posting names none and needs include_unstated, which adds a place-less one only where its head office is (推定); an overseas one never matches",
"minItems": 1,
"maxItems": 47,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
},
"company_type": {
"description": "Only companies of these types: product (own product or service), si_contract (SI, contract work), staffing (dispatch, SES), other_industry, unknown. Judged once per company by a model, about 96% precision for staffing and 100% for product on 148 companies; 7407 of 7722 are tagged. The secondary type is only a hint. No tag fails unless include_unstated",
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"product",
"si_contract",
"staffing",
"other_industry",
"unknown"
]
}
},
"exclude_company_type": {
"description": "Drop companies of these types, judged as above ([\"staffing\"] removes dispatch and SES firms). No tag passes",
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"product",
"si_contract",
"staffing",
"other_industry",
"unknown"
]
}
},
"new_grad": {
"description": "true: only postings aimed at new graduates (the title says 新卒, 27卒, 卒業予定, 第二新卒, or is a selection internship, インターン); new_grad_kind says which. Use it only when the user says they are a new graduate",
"type": "boolean",
"const": true
},
"include_unstated": {
"description": "true: also postings that state nothing for the field, and those not processed (not_extracted). Default: only those that state it and match; experience and english let through those that state nothing, and so does japanese unless it asks not_required; false: not english and japanese either",
"type": "boolean"
},
"company": {
"description": "Company, as in search_jobs",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"sources": {
"description": "as in search_jobs",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
},
"query": {
"description": "Keywords as in search_jobs; leave out to count by the conditions alone",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"sort": {
"description": "salary: annual pay, high to low, by the bottom of the stated range; postings that state no pay last. newest: by date_posted, newest first; known for 111268 of the 145627 postings served (76%), the others last. experience_fit: needs experience.years (the years the user has); postings that state up to those years first, the closest first, then those that state none, then those that state more.",
"type": "string",
"enum": [
"salary",
"newest",
"experience_fit"
]
},
"facets": {
"description": "Count all the matches, not only the page, by any of these (salary_band: the bottom of the stated pay)",
"minItems": 1,
"maxItems": 7,
"type": "array",
"items": {
"type": "string",
"enum": [
"prefecture",
"company_type",
"salary_band",
"employment",
"remote",
"pay_stated",
"overtime_stated"
]
}
},
"limit": {
"description": "Most postings to return (default 10); 0 lists none and returns the total (and the facets) only",
"type": "integer",
"minimum": 0,
"maximum": 25
},
"offset": {
"description": "Where the page starts, in postings from 0 (default 0): the next_offset of the previous page",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}