{"openapi":"3.1.0","info":{"title":"Ranked Jobs API","version":"1.0.0","description":"Public, read-only access to live Tokyo job listings on Ranked (ranked.jp), for AI assistants and developers. The same methods are available as an MCP server at https://jobs.ranked.jp/mcp.","contact":{"name":"Ranked","email":"admin@ranked.jp","url":"https://ranked.jp"}},"servers":[{"url":"https://jobs.ranked.jp"}],"paths":{"/v1/jobs/search":{"get":{"operationId":"searchJobs","summary":"Search Tokyo jobs","description":"Search live job openings in Tokyo, Japan, listed on Ranked (ranked.jp). Built for foreign professionals: filter by whether English is enough, whether Japanese is required, visa sponsorship, remote work and minimum annual salary in yen. Results are ordered by Ranked's rank score. Each job carries its Ranked page, where users can view details and continue to apply, and when the posting was last verified live.","parameters":[{"name":"query","in":"query","required":false,"description":"Keywords matched against title, company, summary and tags, e.g. \"backend go\" or \"robotics\".","schema":{"type":"string"}},{"name":"company","in":"query","required":false,"description":"Only jobs at companies whose name contains this text.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Job category.","schema":{"type":"string","enum":["Software & IT","Business & Corporate Roles","Creative & Media","Engineering & Infrastructure (Physical)","Customer Support & Service","Education & Teaching","Other"]}},{"name":"english_workable","in":"query","required":false,"description":"Only jobs where English is enough (no Japanese requirement stated or reviewed).","schema":{"type":"boolean"}},{"name":"no_japanese_required","in":"query","required":false,"description":"Only jobs that explicitly need no Japanese. Stricter than english_workable.","schema":{"type":"boolean"}},{"name":"visa_sponsorship","in":"query","required":false,"description":"Only jobs whose employer sponsors or may sponsor a work visa. Each result's visa.sponsorship says how sure: supported, likely or possible.","schema":{"type":"boolean"}},{"name":"remote","in":"query","required":false,"description":"Only jobs allowing remote work.","schema":{"type":"boolean"}},{"name":"employment_type","in":"query","required":false,"schema":{"type":"string","enum":["full_time","part_time","contract","freelance","internship","temporary","new_grad"]}},{"name":"salary_min","in":"query","required":false,"description":"Minimum annual salary in JPY, e.g. 8000000. Jobs with no stated salary are excluded.","schema":{"type":"integer","minimum":0}},{"name":"posted_within_days","in":"query","required":false,"description":"Only jobs first seen within this many days.","schema":{"type":"integer","minimum":1,"maximum":365}},{"name":"limit","in":"query","required":false,"description":"Results per page.","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}},{"name":"offset","in":"query","required":false,"description":"Results to skip, for paging.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Matching jobs","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"}}}},"/v1/jobs/{id}":{"get":{"operationId":"getJob","summary":"Get job details","description":"Full details of one Ranked job by id: the complete description, salary, Japanese/English requirements, visa sponsorship, Ranked page URL for details and applying, and source freshness.","parameters":[{"name":"id","in":"path","required":true,"description":"Job id from a search result","schema":{"type":"string"}}],"responses":{"200":{"description":"The job","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"No live job with this id"}}}},"/v1/companies/search":{"get":{"operationId":"searchCompanies","summary":"Search companies","description":"Search companies hiring in Tokyo on Ranked, by keywords over name, industry and description.","parameters":[{"name":"query","in":"query","required":false,"description":"Keywords, e.g. \"fintech\" or \"game studio\".","schema":{"type":"string"}},{"name":"hiring_only","in":"query","required":false,"description":"Only companies with open jobs on Ranked.","schema":{"type":"boolean","default":true}},{"name":"limit","in":"query","required":false,"description":"Results per page.","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}},{"name":"offset","in":"query","required":false,"description":"Results to skip, for paging.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Matching companies","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"}}}},"/v1/companies/{id}":{"get":{"operationId":"getCompany","summary":"Get company details","description":"One company's profile on Ranked and its open Tokyo jobs.","parameters":[{"name":"id","in":"path","required":true,"description":"Company id, e.g. keyence","schema":{"type":"string"}}],"responses":{"200":{"description":"The company and its open jobs","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"No such company"}}}}}}