{"openapi":"3.1.0","info":{"title":"Maiev public API","version":"1.0.0","description":"Read-only access to Maiev's Web3 jobs feed (refreshed regularly) and skill leaderboards. No key needed. For MCP clients, use https://app.maiev.xyz/mcp instead. Docs: https://app.maiev.xyz/agents"},"servers":[{"url":"https://app.maiev.xyz"}],"paths":{"/api/public/jobs":{"get":{"operationId":"searchJobs","summary":"Search open Web3 jobs, or get one listing by id","parameters":[{"name":"id","in":"query","schema":{"type":"string"},"description":"A listing id (returns one listing with its full description)"},{"name":"q","in":"query","schema":{"type":"string"},"description":"Words in the title, company, location or skills"},{"name":"skill","in":"query","schema":{"type":"string"},"description":"e.g. Solidity, Rust, Zero-knowledge proofs"},{"name":"area","in":"query","schema":{"type":"string","enum":["engineering","security","ai","product","design","qa","marketing","business-development","trading","operations"]}},{"name":"region","in":"query","schema":{"type":"string","enum":["remote","na","eu","apac","au","latam","mea"]}},{"name":"remote","in":"query","schema":{"type":"boolean"}},{"name":"company","in":"query","schema":{"type":"string"}},{"name":"minSalaryUsd","in":"query","schema":{"type":"number"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Matching jobs (newest first) with totals, or one listing"},"404":{"description":"No open listing with that id"}}}},"/api/public/news":{"get":{"operationId":"builderNews","summary":"This week's most useful stories for Web3 builders, ranked by builders' votes, with Built by","parameters":[{"name":"sort","in":"query","schema":{"type":"string","enum":["top","latest"],"default":"top"}},{"name":"topic","in":"query","schema":{"type":"string","enum":["security","releases","research","ecosystem"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":40,"default":20}}],"responses":{"200":{"description":"Stories with source, date, topic, consensus (usefulPct once 3+ builders voted) and Built by"}}}},"/api/public/topics":{"get":{"operationId":"jobTopics","summary":"Skills, areas, regions and companies with open roles","responses":{"200":{"description":"Topic pages with counts"}}}},"/api/public/leaderboard":{"get":{"operationId":"leaderboard","summary":"Top builders in a skill, or the list of boards when no skill is given","parameters":[{"name":"skill","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Ranked rows"},"404":{"description":"Unknown skill (lists valid ones)"}}}},"/api/public/salaries":{"get":{"operationId":"salaryIndex","summary":"What Web3 roles pay: median and middle-half annual USD salaries by area, skill, seniority and region","parameters":[{"name":"topic","in":"query","schema":{"type":"string"},"description":"An area (engineering, security, ai, ...) or a skill (Solidity, Rust, ...); none for every area and the top skills"}],"responses":{"200":{"description":"Salary figures"},"404":{"description":"Unknown topic (lists valid ones)"}}}},"/api/public/rank":{"get":{"operationId":"builderRank","summary":"Where a GitHub user ranks on Maiev (best skill, rank and scope); may estimate from public GitHub for people not yet ranked","parameters":[{"name":"gh","in":"query","required":true,"schema":{"type":"string"},"description":"A GitHub username or github.com/username"}],"responses":{"200":{"description":"{found, login, skill, rank, place, scope, estimated?} or {found:false, reason?}"},"400":{"description":"Not a GitHub username"},"503":{"description":"Temporarily unavailable"}}}}}}