{"openapi":"3.1.0","info":{"title":"LANDTHATROLE Jobs API","version":"1.0.0","description":"Free, read-only search over tech jobs in the United States and Canada, taken from employers' own hiring systems (Greenhouse, Lever, Workday, Ashby and others). No key needed; about 60 requests a minute per IP. Link to `url` or `apply_url` when showing a job.","contact":{"url":"https://www.landthatrole.com/contact"},"termsOfService":"https://www.landthatrole.com/terms"},"servers":[{"url":"https://www.landthatrole.com"}],"externalDocs":{"description":"Connect from Claude, ChatGPT and other AI apps","url":"https://www.landthatrole.com/connect"},"paths":{"/api/v1/jobs":{"get":{"operationId":"searchJobs","summary":"Search open tech jobs","description":"Newest first unless sort=salary. Without q or role, returns all open tech jobs.","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":100},"description":"Words in the job title or company, e.g. react, data engineer, Shopify."},{"name":"role","in":"query","schema":{"type":"string"},"description":"A role slug from /api/v1/categories, e.g. data-engineering, frontend-developer."},{"name":"country","in":"query","schema":{"type":"string","enum":["US","CA"]}},{"name":"city","in":"query","schema":{"type":"string","maxLength":60},"description":"City name, e.g. Toronto, San Francisco."},{"name":"work_mode","in":"query","schema":{"type":"string"},"description":"remote, hybrid or onsite; comma-separate for several."},{"name":"salary_min","in":"query","schema":{"type":"number","minimum":0},"description":"Lowest top-of-range salary, in the posting's currency."},{"name":"posted_within_days","in":"query","schema":{"type":"number","minimum":1},"description":"Rounded up to 1, 7 or 30 days; above 30 means no limit."},{"name":"sort","in":"query","schema":{"type":"string","enum":["recent","salary"],"default":"recent"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":"Use next_offset from the previous page."}],"responses":{"200":{"description":"Matching jobs","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"next_offset":{"type":["integer","null"]},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"attribution":{"type":"string"}}}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests"}}}},"/api/v1/jobs/{id}":{"get":{"operationId":"getJob","summary":"One job, with its description as plain text","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The job","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Job"},{"type":"object","properties":{"description":{"type":"string"},"description_truncated":{"type":"boolean"}}}]}}}},"404":{"description":"No such job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/categories":{"get":{"operationId":"listCategories","summary":"Role slugs and locations the search accepts","responses":{"200":{"description":"Role groups, single roles and locations"}}}}},"components":{"schemas":{"Job":{"type":"object","required":["id","title","company","url","open"],"properties":{"id":{"type":"string","description":"Stable id; pass it to /api/v1/jobs/{id}."},"title":{"type":"string"},"company":{"type":"string"},"location":{"type":["string","null"],"examples":["Toronto, Ontario"]},"country":{"type":["string","null"],"enum":["US","CA",null]},"work_mode":{"type":["string","null"],"enum":["remote","hybrid","onsite",null]},"employment_type":{"type":["string","null"]},"experience_level":{"type":["string","null"]},"salary":{"type":["object","null"],"properties":{"min":{"type":["number","null"]},"max":{"type":["number","null"]},"currency":{"type":"string","examples":["USD","CAD"]},"period":{"type":"string","enum":["year","month","week","day","hour"]}}},"posted_at":{"type":["string","null"],"format":"date-time"},"url":{"type":"string","format":"uri","description":"The job's page on LANDTHATROLE."},"apply_url":{"type":["string","null"],"format":"uri","description":"The employer's own posting, where applications go."},"source":{"type":["string","null"],"description":"The employer's hiring system, e.g. greenhouse, workday."},"skills":{"type":"array","items":{"type":"string"}},"open":{"type":"boolean","description":"False once the employer has closed the posting."}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"docs":{"type":"string","format":"uri"}}}}}}