{"openapi":"3.0.3","info":{"title":"Career Index Data API","version":"1.0.0","description":"Open jobs from public career pages on Greenhouse, Ashby, Lever and SmartRecruiters (refreshed nightly) and Workday (refreshed about twice a month; ats=workday). Free tier needs no key; Starter (US$29/month) adds daily full export, 1,000 rows per request, since filter and CSV."},"servers":[{"url":"https://career-index-api.printfilestudio.workers.dev"}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Job":{"type":"object","properties":{"id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"company":{"type":"string","nullable":true},"companySlug":{"type":"string","nullable":true},"ats":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"remote":{"type":"boolean"},"roleCategory":{"type":"string","nullable":true},"roleSlug":{"type":"string","nullable":true},"postedAt":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"applyUrl":{"type":"string","nullable":true},"department":{"type":"string","nullable":true},"employmentType":{"type":"string","nullable":true},"scrapedAt":{"type":"string","nullable":true}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","bad_request","not_found","rate_limited","unavailable"]},"message":{"type":"string"}}}}}}},"paths":{"/v1/meta":{"get":{"summary":"Index info","responses":{"200":{"description":"{jobs, companies, updatedAt, ats, sources}; sources lists the update date and refresh rate of the daily boards and of Workday"}}}},"/v1/companies":{"get":{"summary":"List companies","security":[{},{"ApiKey":[]}],"parameters":[{"name":"ats","in":"query","schema":{"type":"string"}},{"name":"minJobs","in":"query","schema":{"type":"integer"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"{page, limit, total, hasMore, updatedAt, companies:[{slug,name,ats,jobs,remoteJobs}]}"},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/jobs":{"get":{"summary":"List jobs; exactly one of company, role, location is required","security":[{},{"ApiKey":[]}],"parameters":[{"name":"company","in":"query","schema":{"type":"string"}},{"name":"role","in":"query","schema":{"type":"string"}},{"name":"location","in":"query","schema":{"type":"string"}},{"name":"since","in":"query","description":"YYYY-MM-DD (Starter)","schema":{"type":"string"}},{"name":"remote","in":"query","schema":{"type":"boolean"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","description":"Max 20 free, 1000 Starter","schema":{"type":"integer"}},{"name":"format","in":"query","description":"csv requires Starter","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"{page, limit, total, hasMore, updatedAt, jobs:[Job]}","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"$ref":"#/components/schemas/Job"}}}}}}},"401":{"description":"Invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Plan does not allow this"},"429":{"description":"Rate limited"}}}},"/v1/export":{"get":{"summary":"List full-export parts (Starter)","security":[{"ApiKey":[]}],"responses":{"200":{"description":"{updatedAt, parts:[{url,bytes,jobs}]}"},"401":{"description":"Invalid key"},"403":{"description":"Free plan"}}}},"/v1/export/{part}":{"get":{"summary":"Download one gzip JSON Lines part (Starter)","security":[{"ApiKey":[]}],"parameters":[{"name":"part","in":"path","required":true,"schema":{"type":"string","example":"part-00.jsonl.gz"}}],"responses":{"200":{"description":"application/gzip"},"404":{"description":"Unknown part"}}}}}}