{"name":"YIMBY Action Public API","version":"1.0.0","description":"Free, anonymous, read-only access to YIMBY Action's published election guides, endorsements, candidate profiles, ballot matches, recorded representatives, chapters, events and reviewed search catalog. No account, API key or OAuth grant is required. This API cannot read private CMS records, submit forms or change content. Cite returned source URLs; search results are excerpts, not a complete voter guide. Follow each guide for its election date and endorsement details.","authentication":{"required":false},"versioning":"The public REST API uses URL path versioning: /api/public/v1/. Existing /api/public/search and /api/public/chapters URLs remain compatible aliases of v1. Breaking changes require a new major-version URL; additive optional fields may be introduced within v1. No version is currently deprecated and no retirement date is scheduled. Before retiring a version, publish migration instructions in /developers and announce deprecation on affected responses using Deprecation (RFC 9745), Sunset (RFC 8594) and a Link with rel=deprecation. Never infer deprecation from a missing header.","links":{"documentation":"/developers","agent_instructions":"/agent-instructions.md","cli_source":"/cli/yimby-action.mjs","openapi":"/openapi.json","mcp":"/mcp","instructions":"/llms.txt"},"operations":[{"operationId":"searchYimbyAction","method":"GET","path":"/api/public/v1/search","summary":"Search YIMBY Action"},{"operationId":"listYimbyChapters","method":"GET","path":"/api/public/v1/chapters","summary":"List active YIMBY Action chapters"},{"operationId":"listYimbyElections","method":"GET","path":"/api/public/v1/elections","summary":"List published YIMBY Action election guides"},{"operationId":"findYimbyEndorsements","method":"GET","path":"/api/public/v1/endorsements","summary":"Find YIMBY Action candidate and ballot measure endorsements"},{"operationId":"findYimbyCandidates","method":"GET","path":"/api/public/v1/candidates","summary":"Find public YIMBY Action candidate profiles"},{"operationId":"getYimbyCandidate","method":"GET","path":"/api/public/v1/candidate","summary":"Read a public YIMBY Action candidate profile"},{"operationId":"getYimbyBallot","method":"POST","path":"/api/public/v1/ballot","summary":"Find YIMBY Action endorsements for an address or area"},{"operationId":"getYimbyRepresentatives","method":"POST","path":"/api/public/v1/representatives","summary":"Find current representatives for an address or area"},{"operationId":"findYimbyChaptersNear","method":"GET","path":"/api/public/v1/chapters-near","summary":"Find active YIMBY chapters near a city or ZIP"},{"operationId":"listYimbyEvents","method":"GET","path":"/api/public/v1/events","summary":"List upcoming national or active chapter events"}],"examples":["/api/public/v1/search?q=housing&type=policies","/api/public/v1/chapters?state=CA"]}