{"ok":true,"site":"openverse","host":"openverse.org","about":"Openverse (openverse.org) is a search engine for openly licensed images and audio. This CLI calls its public REST API at api.openverse.org/v1 to search media, get item details and related items, fetch audio waveforms and oEmbed data, list content sources, and check the anonymous rate limit.","commands":[{"command":"search-images","summary":"Search openly licensed images by keyword, with filters for license, category, aspect ratio, size, source, tags and creator","params":[{"name":"q","type":"string","required":true,"description":"Search keywords"},{"name":"page","type":"number","description":"Result page number, starting at 1","default":1},{"name":"page_size","type":"number","description":"Results per page. Anonymous requests are capped at 20.","default":20},{"name":"license","type":"string","description":"Comma-separated license codes, e.g. by,by-sa,by-nd,by-nc,by-nc-sa,by-nc-nd,cc0,pdm"},{"name":"license_type","type":"string","description":"Comma-separated usage permissions the license must allow","oneOf":["commercial","modification"]},{"name":"category","type":"string","description":"Image category","oneOf":["photograph","illustration","digitized_artwork"]},{"name":"aspect_ratio","type":"string","description":"Image aspect ratio","oneOf":["tall","wide","square"]},{"name":"size","type":"string","description":"Image size","oneOf":["small","medium","large"]},{"name":"source","type":"string","description":"Comma-separated source names, e.g. flickr,wikimedia (see list-image-sources)"},{"name":"tags","type":"string","description":"Match images with these tags"},{"name":"creator","type":"string","description":"Match images by this creator name"}],"exampleUrl":"https://clify-dev.netlify.app/openverse/search-images?q=cat&license=cc0%2Cby"},{"command":"get-image-oembed","summary":"Get oEmbed data for an Openverse image page URL, for embedding with attribution","params":[{"name":"url","type":"string","required":true,"description":"Openverse image page URL in the form https://openverse.org/image/<id>, where <id> is the image UUID from search-images"}],"exampleUrl":"https://clify-dev.netlify.app/openverse/get-image-oembed?url=https%3A%2F%2Fopenverse.org%2Fimage%2F1c5442f6-6bb6-4ab7-b603-f598e7579dd2"},{"command":"list-image-sources","summary":"List all image content sources (e.g. flickr, wikimedia) with their media counts","params":[],"exampleUrl":"https://clify-dev.netlify.app/openverse/list-image-sources"},{"command":"search-audio","summary":"Search openly licensed audio by keyword, with filters for category, length, file extension, license and source","params":[{"name":"q","type":"string","required":true,"description":"Search keywords"},{"name":"page","type":"number","description":"Result page number, starting at 1","default":1},{"name":"page_size","type":"number","description":"Results per page. Anonymous requests are capped at 20.","default":20},{"name":"category","type":"string","description":"Audio category","oneOf":["music","sound_effect","podcast","audiobook","news","pronunciation"]},{"name":"length","type":"string","description":"Audio duration bucket","oneOf":["shortest","short","medium","long"]},{"name":"extension","type":"string","description":"File extension, e.g. mp3, ogg, flac, wav"},{"name":"license","type":"string","description":"Comma-separated license codes, e.g. by,by-sa,cc0,pdm"},{"name":"license_type","type":"string","description":"Comma-separated usage permissions the license must allow","oneOf":["commercial","modification"]},{"name":"source","type":"string","description":"Comma-separated source names, e.g. freesound,jamendo (see list-audio-sources)"}],"exampleUrl":"https://clify-dev.netlify.app/openverse/search-audio?q=piano"},{"command":"list-audio-sources","summary":"List all audio content sources (e.g. freesound, jamendo) with their media counts","params":[],"exampleUrl":"https://clify-dev.netlify.app/openverse/list-audio-sources"},{"command":"get-rate-limit","summary":"Show the current API rate-limit status for this client (requests used and remaining)","params":[],"exampleUrl":"https://clify-dev.netlify.app/openverse/get-rate-limit"}]}