{"openapi":"3.1.0","info":{"title":"Free Chord Book API","description":"Search and retrieve free guitar chords, tabs, and lyrics for 670,000+ songs. Built for AI assistants (ChatGPT, Claude, Gemini, Perplexity) to answer chord requests in chat.","version":"1.0.0","contact":{"url":"https://www.free-chords.com"}},"servers":[{"url":"https://www.free-chords.com"}],"paths":{"/api/v1/search":{"get":{"summary":"Search songs by title or artist","operationId":"searchSongs","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"wonderwall oasis"},{"name":"limit","in":"query","schema":{"type":"integer","default":10,"maximum":50}},{"name":"type","in":"query","schema":{"type":"string","enum":["all","chord","tab"],"default":"all"}}],"responses":{"200":{"description":"Search results with api_url to fetch full content"}}}},"/api/v1/songs/{tabId}":{"get":{"summary":"Get full chord sheet or tab by ID","operationId":"getSong","parameters":[{"name":"tabId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"type","in":"query","schema":{"type":"string","enum":["chord","tab"],"default":"chord"}}],"responses":{"200":{"description":"Song with content, plain_text, chords, chord_diagrams, attribution"},"404":{"description":"Song not found"}}}},"/api/v1/autocomplete":{"get":{"summary":"Fast typeahead for artist/song names","operationId":"autocomplete","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artist and song suggestions"}}}}},"externalDocs":{"description":"LLM integration guide","url":"https://www.free-chords.com/llms.txt"}}