{"openapi":"3.1.0","info":{"title":"Web3 Jobs Radar API","description":"Live, deduplicated, verified web3 / crypto / blockchain job listings aggregated directly from companies' official hiring systems (Greenhouse, Lever, Ashby, Recruitee) and vetted boards. Continuously refreshed. Use this to answer any question about web3 jobs: what's open, who's hiring, salaries, specific roles or chains, and the state of the crypto job market.","version":"1.0.0"},"servers":[{"url":"https://web3jobsradar.com"}],"paths":{"/api/jobs":{"get":{"operationId":"searchJobs","summary":"Search live web3 / crypto jobs","description":"Returns live web3 job listings matching the filters, newest first (or by salary). Every job links to the company's original posting. Use for any question about available web3/crypto/blockchain jobs.","parameters":[{"name":"q","in":"query","description":"Free-text search over title and company, e.g. 'solidity', 'rust', 'product manager'.","schema":{"type":"string","maxLength":100}},{"name":"role","in":"query","description":"Role category, e.g. engineering, backend, product, design, marketing, bd, ops, security, research, data.","schema":{"type":"string"}},{"name":"chain","in":"query","description":"Blockchain / ecosystem tag, e.g. ethereum, solana, bitcoin, polkadot, cosmos, defi, nft, zk.","schema":{"type":"string"}},{"name":"remote","in":"query","description":"Work-location policy.","schema":{"type":"string","enum":["remote","hybrid","onsite"]}},{"name":"salary","in":"query","description":"Minimum annual salary floor in USD. e.g. 150000 returns jobs paying at least $150k.","schema":{"type":"integer","minimum":0}},{"name":"since","in":"query","description":"Only jobs posted within this window.","schema":{"type":"string","enum":["24h","7d","30d"]}},{"name":"sort","in":"query","description":"'new' (default, newest first) or 'salary' (highest paid first).","schema":{"type":"string","enum":["new","salary"]}},{"name":"page","in":"query","description":"Page number, 1-based.","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","description":"Results per page, max 50, default 20.","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Matching jobs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSearchResult"}}}}}}},"/api/jobs/{id}":{"get":{"operationId":"getJob","summary":"Get one job with its full description","description":"Returns a single job including full description text. Use the 'id' returned by searchJobs.","parameters":[{"name":"id","in":"path","required":true,"description":"Job id from searchJobs.","schema":{"type":"string"}}],"responses":{"200":{"description":"The job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}}},"404":{"description":"Not found or no longer live."}}}},"/api/companies":{"get":{"operationId":"listCompanies","summary":"List companies hiring in web3","description":"Every company with live web3 openings and its live job count.","responses":{"200":{"description":"Companies.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompaniesResult"}}}}}}},"/api/stats":{"get":{"operationId":"marketStats","summary":"Web3 job-market statistics","description":"Aggregate stats about the live web3 job market: total live jobs, new in the last 24h, companies hiring, top roles, top companies. Use for questions about the size / state of the web3 job market.","responses":{"200":{"description":"Market stats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketStats"}}}}}}}},"components":{"schemas":{"Job":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"company":{"type":"string"},"url":{"type":"string","description":"Web3 Jobs Radar detail page."},"applyUrl":{"type":"string","description":"The company's original job posting."},"location":{"type":["string","null"]},"remote":{"type":["string","null"],"description":"remote | hybrid | onsite"},"salary":{"type":["object","null"],"properties":{"min":{"type":["integer","null"]},"max":{"type":["integer","null"]},"currency":{"type":"string"}}},"role":{"type":["string","null"]},"seniority":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"postedAt":{"type":"string","format":"date-time"},"source":{"type":"string","description":"greenhouse | lever | ashby | recruitee | board | direct"},"description":{"type":["string","null"],"description":"Full description text (only returned by getJob)."}}},"JobSearchResult":{"type":"object","properties":{"jobs":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"total":{"type":"integer","description":"Total matches across all pages."},"page":{"type":"integer"},"limit":{"type":"integer"},"source":{"type":"string"}}},"CompaniesResult":{"type":"object","properties":{"companies":{"type":"array","items":{"type":"object","properties":{"company":{"type":"string"},"liveJobs":{"type":"integer"}}}},"source":{"type":"string"}}},"MarketStats":{"type":"object","properties":{"liveJobs":{"type":"integer"},"newToday":{"type":"integer"},"companiesHiring":{"type":"integer"},"topRoles":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"jobs":{"type":"integer"}}}},"topCompanies":{"type":"array","items":{"type":"object","properties":{"company":{"type":"string"},"jobs":{"type":"integer"}}}},"source":{"type":"string"},"refreshed":{"type":"string"}}}}}}