{"info":{"description":"Anonymous GET access to official job evidence. Preserve dates and coverage warnings. Country in changes is ISO alpha-2; search country uses canonical names. Salary filters require currency and period.","title":"OpenNash Jobs read-only API","version":"0.2.0"},"openapi":"3.1.0","paths":{"/api/changes":{"get":{"parameters":[{"in":"query","name":"company","required":false,"schema":{"type":"string"}},{"in":"query","name":"since","required":false,"schema":{"type":"string"}},{"in":"query","name":"function","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"event","required":false,"schema":{"enum":["new","removed","returned"],"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"build_id":{"type":"string"},"changes_available":{"type":"boolean"},"evidence_date":{"type":"string"},"next_cursor":{"type":["string","null"]},"results":{"items":{"properties":{"company_uri":{"type":"string"},"completeness_status":{"type":"string"},"country_code":{"type":"string"},"event":{"type":"string"},"event_date":{"type":"string"},"event_id":{"type":"string"},"function":{"type":"string"},"official_url":{"type":"string"},"raw_function":{"type":"string"},"result_id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Read dated job changes"}},"/api/companies/{uri}/trends":{"get":{"parameters":[{"in":"path","name":"uri","required":true,"schema":{"type":"string"}},{"in":"query","name":"weeks","required":false,"schema":{"default":26,"maximum":26,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"build_id":{"type":"string"},"changes_available":{"type":"boolean"},"evidence_date":{"type":"string"},"results":{"items":{"properties":{"ai_requirement_roles":{"type":"integer"},"comparison_status":{"type":"string"},"described":{"type":"integer"},"evidence_date":{"type":"string"},"new":{"type":["integer","null"]},"open":{"type":"integer"},"remote_roles":{"type":"integer"},"removed":{"type":["integer","null"]},"week":{"type":"string"}},"type":"object"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Read company weekly trends"}},"/api/company-coverage":{"get":{"parameters":[{"in":"query","name":"company","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"matches":{"items":{"properties":{"company_name":{"type":"string"},"company_uri":{"type":"string"},"last_verified_at":{"type":"string"}},"type":"object"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Read employer coverage"}},"/api/health":{"get":{"parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"search":{"type":"object"},"status":{"type":"string"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Check service health"}},"/api/job":{"get":{"parameters":[{"in":"query","name":"result_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"found":{"type":"boolean"},"job":{"properties":{"application_window":{"type":"object"},"company_name":{"type":"string"},"company_uri":{"type":"string"},"domain":{"type":"string"},"evidence":{"type":"object"},"official_url":{"type":"string"},"result_id":{"type":"string"},"title":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Read a job"}},"/api/jobs-health":{"get":{"parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"failures":{"items":{"type":"string"},"type":"array"},"status":{"type":"string"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Check search evidence readiness"}},"/api/jobs/{id}/history":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"build_id":{"type":"string"},"changes_available":{"type":"boolean"},"evidence_date":{"type":"string"},"found":{"type":"boolean"},"job":{"type":["object","null"]},"result_id":{"type":"string"},"results":{"items":{"properties":{"company_uri":{"type":"string"},"completeness_status":{"type":"string"},"country_code":{"type":"string"},"event":{"type":"string"},"event_date":{"type":"string"},"event_id":{"type":"string"},"function":{"type":"string"},"official_url":{"type":"string"},"raw_function":{"type":"string"},"result_id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Read retained job history"}},"/api/market/trends":{"get":{"parameters":[{"in":"query","name":"dimension","required":false,"schema":{"default":"function","enum":["function","country","seniority"],"type":"string"}},{"in":"query","name":"weeks","required":false,"schema":{"default":26,"maximum":26,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"build_id":{"type":"string"},"changes_available":{"type":"boolean"},"evidence_date":{"type":"string"},"results":{"items":{"properties":{"companies":{"type":"integer"},"completeness_status":{"type":"string"},"dimension":{"type":"string"},"evidence_date":{"type":"string"},"open":{"type":"integer"},"partial_companies":{"type":"integer"},"raw_function":{"items":{"type":"string"},"type":"array"},"value":{"type":"string"},"week":{"type":"string"}},"type":"object"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Read weekly market trends"}},"/api/search":{"get":{"parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"company","required":false,"schema":{"type":"string"}},{"in":"query","name":"location","required":false,"schema":{"type":"string"}},{"in":"query","name":"city","required":false,"schema":{"type":"string"}},{"in":"query","name":"region","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"type":"string"}},{"in":"query","name":"industry","required":false,"schema":{"type":"string"}},{"in":"query","name":"work_mode","required":false,"schema":{"type":"string"}},{"in":"query","name":"employment_type","required":false,"schema":{"type":"string"}},{"in":"query","name":"seniority","required":false,"schema":{"type":"string"}},{"in":"query","name":"pay_currency","required":false,"schema":{"type":"string"}},{"in":"query","name":"pay_period","required":false,"schema":{"type":"string"}},{"in":"query","name":"posted_after","required":false,"schema":{"type":"string"}},{"in":"query","name":"scope","required":false,"schema":{"default":"us","enum":["us","global"],"type":"string"}},{"in":"query","name":"sort","required":false,"schema":{"enum":["relevance","newest","company"],"type":"string"}},{"in":"query","name":"fresh_only","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"maximum":10000,"minimum":0,"type":"integer"}},{"in":"query","name":"pay_minimum","required":false,"schema":{"type":"number"}},{"in":"query","name":"pay_maximum","required":false,"schema":{"type":"number"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"results":{"items":{"properties":{"application_window":{"type":"object"},"company_name":{"type":"string"},"company_uri":{"type":"string"},"domain":{"type":"string"},"evidence":{"type":"object"},"official_url":{"type":"string"},"result_id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"returned":{"type":"integer"},"total":{"type":"integer"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Dated public evidence; unknown fields stay unknown."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"405":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"429":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."},"503":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"object"}},"type":"object"}}},"description":"Invalid request, unavailable evidence or rate limit."}},"security":[],"summary":"Search official jobs"}}},"servers":[{"url":"https://jobs.opennash.com"}]}