{"openapi":"3.1.0","info":{"title":"Wikimedia Commons API","version":"1.0.0","description":"Search millions of freely-licensed images and media as an API, from Wikimedia Commons. Pass a search term and get matching photos and illustrations with their direct full-resolution image URL, a ready-to-use thumbnail, dimensions, file size, MIME type, and crucially the licence (Creative Commons or public domain), licence URL and author/credit — everything you need to find and correctly attribute reusable media. Or look up a single file by name for its full details. Ideal for blogs, content and marketing tools, presentations, education and apps that need free, attributable imagery. Open data from Wikimedia Commons (always check each file's licence before reuse).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/commons-api","description":"oanor gateway"}],"tags":[{"name":"Commons"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/image":{"get":{"operationId":"get_v1_image","tags":["Commons"],"summary":"One file by name","description":"","parameters":[{"name":"title","in":"query","required":true,"description":"File name, e.g. Example.jpg (File: prefix optional)","schema":{"type":"string"},"example":"Example.jpg"},{"name":"thumb_width","in":"query","required":false,"description":"Thumbnail width in px (80-2048, default 640)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"file":{"date":"2026-05-28","mime":"image/jpeg","title":"Example.jpg","width":172,"author":"","credit":"Own work","height":178,"license":"Public domain","page_url":"https://commons.wikimedia.org/wiki/File:Example.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg","categories":"PD ineligible|PD text|Protected files|Vector version available|Example images|Commons prohibited file names|English-language image placeholders|PD-text missing SDC copyright status","size_bytes":9022,"thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg"}},"meta":{"timestamp":"2026-05-31T11:06:35.152Z","request_id":"23c0a66f-a2d3-468e-85c2-d81522a2bddf"},"status":"ok","message":"File retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Commons"],"summary":"Search Commons for media","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term, e.g. mountain, eiffel tower","schema":{"type":"string"},"example":"mountain"},{"name":"limit","in":"query","required":false,"description":"Results per page (1-50, default 12)","schema":{"type":"string"},"example":"12"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"},{"name":"thumb_width","in":"query","required":false,"description":"Thumbnail width in px (80-1024, default 320)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":12,"limit":12,"query":"mountain","total":12,"offset":0,"results":[{"date":"2009-10-18 12:40:30","mime":"image/jpeg","title":"Himalayas, Ama Dablam, Nepal.jpg","width":4032,"author":"Vyacheslav Argenberg","credit":"Own work","height":2688,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Himalayas,_Ama_Dablam,_Nepal.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/2/29/Himalayas%2C_Ama_Dablam%2C_Nepal.jpg","categories":"Ama Dablam|Malanphulan|Photos by Vyacheslav Argenberg|Images with annotations|Self-published work|Featured pictures on Wikipedia, English|Featured pictures of Nepal|Featured pictures on Wikipedia, Spanish|Photographs taken on 2009-10-18|Mountains with clouds|October 2009 Nepal photographs|Clouds and blue sky in Nepal|Mountains with snow in Nepal|Snow in Nepal in October|Featured pictures of the Himalayas|Photos by Vyacheslav Argenberg in Nepal|Photos by Vyacheslav Argenberg in 2009","size_bytes":7665281,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/2/29/Himalayas%2C_Ama_Dablam%2C_Nepal.jpg/330px-Himalayas%2C_Ama_Dablam%2C_Nepal.jpg"},{"date":"2009-10-19 14:56:21","mime":"image/jpeg","title":"Everest, Himalayas.jpg","width":4032,"author":"Vyacheslav Argenberg","credit":"Own work","height":2688,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Everest,_Himalayas.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/9/90/Everest%2C_Himalayas.jpg","categories":"Views of Mount Everest from Kala Patthar|Photos by Vyacheslav Argenberg|Self-published work|Featured pictures of Nepal|Blue sky in Nepal|Featured pictures on Wikipedia, Vietnamese|Photographs taken on 2009-10-19|October 2009 Nepal photographs|Mountains with snow in Nepal|Snow in Nepal in October|Featured pictures of the Himalayas|Ice cliffs of the Himalayas|Photos by Vyacheslav Argenberg in Nepal|Photos by Vyacheslav Argenberg in 2009","size_bytes":8357266,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/9/90/Everest%2C_Himalayas.jpg/330px-Everest%2C_Himalayas.jpg"},{"date":"2015-08-12 13:48:27","mime":"image/jpeg","title":"Zagedan Lakes, Mountain cirque, Caucasus Mountains.jpg","width":4912,"author":"Vyacheslav Argenberg","credit":"Own work","height":3264,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Zagedan_Lakes,_Mountain_cirque,_Caucasus_Mountains.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/8/88/Zagedan_Lakes%2C_Mountain_cirque%2C_Caucasus_Mountains.jpg","categories":"Western Caucasus|Photos by Vyacheslav Argenberg|Mountain lakes|Self-published work|Cirques in Russia|Mountains with clouds in Russia|Featured pictures of Karachay-Cherkessia|Water reflections of mountains in Russia|Glacial geomorphology of Russia|2015 in Karachay-Cherkessia|Files with coordinates missing SDC location of creation|Russia photographs taken on 2015-08-12|River sources in Russia|Reflections in lakes in Russia|Clouds and blue sky in Karachay-Cherkessia|Lakes in summer|Mountains in summer|Shadows of clouds on mountains|Caucasus mountains of Karachay-Cherkessia|Rock formations of the Caucasus|Photos by Vyacheslav Argenberg in Caucasus, Russia|Photos by Vyacheslav Argenberg in 2015","size_bytes":16445409,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/8/88/Zagedan_Lakes%2C_Mountain_cirque%2C_Caucasus_Mountains.jpg/330px-Zagedan_Lakes%2C_Mountain_cirque%2C_Caucasus_Mountains.jpg"},{"date":"2009-10-18 11:49:26","mime":"image/jpeg","title":"Mountains in snow, Mountain lake, Chola Valley, Nepal, Himalayas.jpg","width":4032,"author":"Vyacheslav Argenberg","credit":"Own work","height":2688,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Mountains_in_snow,_Mountain_lake,_Chola_Valley,_Nepal,_Himalayas.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/5/5a/Mountains_in_snow%2C_Mountain_lake%2C_Chola_Valley%2C_Nepal%2C_Himalayas.jpg","categories":"Ama Dablam|Taboche|Malanphulan|Cho La pass|Photos by Vyacheslav Argenberg|Valleys of Nepal|Images with annotations|Mountain lakes|Proglacial lakes|Self-published work|Featured pictures of Nepal|Landscapes of Nepal|Rocks in Nepal|Photographs taken on 2009-10-18|October 2009 Nepal photographs|Uploaded via Campaign:wle-np|Featured pictures of lakes|Files with coordinates missing SDC location of creation|Clouds and blue sky in Nepal|Mountains with snow in Nepal|Mountains with clouds in Nepal|Snow in Nepal in October|Images from Wiki Loves Earth 2023|Images from Wiki Loves Earth 2023 in Nepal|Images from Wiki Loves Earth missing SDC location of creation|Featured pictures of the Himalayas|Sunny and shady mountainsides|Photos by Vyacheslav Argenberg in Nepal|Glaciated mountains in Asia|Photos by Vyacheslav Argenberg in 2009","size_bytes":7417279,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/5/5a/Mountains_in_snow%2C_Mountain_lake%2C_Chola_Valley%2C_Nepal%2C_Himalayas.jpg/330px-Mountains_in_snow%2C_Mountain_lake%2C_Chola_Valley%2C_Nepal%2C_Himalayas.jpg"},{"date":"2010","mime":"image/jpeg","title":"Uluguru Mountain Ranges.jpg","width":6498,"author":"Muhammad Mahdi Karim","credit":"Own work","height":1016,"license":"GFDL 1.2","page_url":"https://commons.wikimedia.org/wiki/File:Uluguru_Mountain_Ranges.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/d/d2/Uluguru_Mountain_Ranges.jpg","categories":"Uluguru Mountains|GFDL-1.2|Featured pictures of Tanzania|2010 photographs of Tanzania|Self-published work|Featured pictures on Wikipedia, English|Panoramas of Tanzania|Photographs by Muhammad Mahdi Karim|Featured pictures by Muhammad Mahdi Karim|Files with derivative versions|Featured pictures of mountains|Panoramas of mountains|Assessment tagged pages marked as POTY candidates","size_bytes":5847705,"license_url":"http://www.gnu.org/licenses/old-licenses/fdl-1.2.html","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/d/d2/Uluguru_Mountain_Ranges.jpg/330px-Uluguru_Mountain_Ranges.jpg"},{"date":"January 28, 2004, 10:01:59 GMT","mime":"image/jpeg","title":"Himalayas.jpg","width":3032,"author":"NASA","credit":"http://www.nasa.gov/multimedia/imagegallery/image_feature_152.html Original unprocessed image: http://eol.jsc.nasa.gov/scripts/sseop/photo.pl?mission=ISS008&roll=E&frame=13304","height":1998,"license":"Public domain","page_url":"https://commons.wikimedia.org/wiki/File:Himalayas.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/7/79/Himalayas.jpg","categories":"Rongbuk Glacier|Mahalangur Himal|Images with annotations|Yarlung Tsangpo|Featured pictures on Wikipedia, English|Formerly featured pictures on Wikimedia Commons|Featured pictures on Wikipedia, Indonesian|Featured pictures on Wikipedia, Persian|Featured pictures on Wikipedia, Turkish|Images with 10+ annotations|Aerial photographs of the Himalayas|Photos of Asia from ISS|Aerial photographs of Tibet|ISS Expedition 8 Crew Earth Observations|PD NASA-AP|Himalayas of India|Files from NASA with known IDs|Picture of week on the Malay Wikipedia|Satellite pictures of Mount Everest","size_bytes":3961330,"thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/7/79/Himalayas.jpg/330px-Himalayas.jpg"},{"date":"2014-08-02 12:42:09","mime":"image/jpeg","title":"Mountain lake, Mylgval mountain cirque, Western Caucasus.jpg","width":4912,"author":"Vyacheslav Argenberg","credit":"Own work","height":3264,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Mountain_lake,_Mylgval_mountain_cirque,_Western_Caucasus.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/2/23/Mountain_lake%2C_Mylgval_mountain_cirque%2C_Western_Caucasus.jpg","categories":"Western Caucasus|Photos by Vyacheslav Argenberg|Snow in Russia|Mountain lakes|Lakes of Karachay-Cherkessia|Self-published work|Cirques in Russia|Featured pictures of Karachay-Cherkessia|Russia photographs taken on 2014-08-02|Files with coordinates missing SDC location of creation|Mountains with snow in Russia|Clouds and blue sky in Karachay-Cherkessia|Snow in Europe in August 2014|Lakes in summer|Mountains in summer|Shadows of clouds on mountains|Blue lakes|Caucasus mountains of Karachay-Cherkessia|Rock formations of the Caucasus|Photos by Vyacheslav Argenberg in Caucasus, Russia|Photos by Vyacheslav Argenberg in 2014|Abishira-Akhuba Ridge","size_bytes":15837556,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/2/23/Mountain_lake%2C_Mylgval_mountain_cirque%2C_Western_Caucasus.jpg/330px-Mountain_lake%2C_Mylgval_mountain_cirque%2C_Western_Caucasus.jpg"},{"date":"2013-09-18 14:47:59","mime":"image/jpeg","title":"Sofia Massif and Sofia Glacier, Karachay-Cherkessia, Caucasus Mountains.jpg","width":4912,"author":"Vyacheslav Argenberg","credit":"Own work","height":2760,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Sofia_Massif_and_Sofia_Glacier,_Karachay-Cherkessia,_Caucasus_Mountains.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/1/16/Sofia_Massif_and_Sofia_Glacier%2C_Karachay-Cherkessia%2C_Caucasus_Mountains.jpg","categories":"Western Caucasus|Photos by Vyacheslav Argenberg|Wilderness|Self-published work|Mountains with clouds in Russia|Featured pictures of Karachay-Cherkessia|Files with coordinates missing SDC location of creation|Russia photographs taken on 2013-09-18|Glaciers of the Caucasus Mountains|Snow in Europe in September|Mountains with snow in Russia|Caucasus mountains of Karachay-Cherkessia|Photos by Vyacheslav Argenberg in 2013|Photos by Vyacheslav Argenberg in Caucasus, Russia|Sofia Valley, Arkhyz","size_bytes":9479246,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/1/16/Sofia_Massif_and_Sofia_Glacier%2C_Karachay-Cherkessia%2C_Caucasus_Mountains.jpg/330px-Sofia_Massif_and_Sofia_Glacier%2C_Karachay-Cherkessia%2C_Caucasus_Mountains.jpg"},{"date":"12 September 2020, 06:45:54 (according to Exif data)","mime":"image/jpeg","title":"Mountains of Wadi Shawka denoised.jpg","width":5184,"author":"Original: Florian Kriechbaumer Derivative work: Aristeas","credit":"This file was derived from: Mountains of Wadi Shawka.jpg","height":3888,"license":"CC BY-SA 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Mountains_of_Wadi_Shawka_denoised.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/5/59/Mountains_of_Wadi_Shawka_denoised.jpg","categories":"Retouched pictures|Atmospheric perspective|Wadi Shawka|Self-published work|Featured pictures of the United Arab Emirates|Derivative versions|September 2020 United Arab Emirates photographs|Featured pictures of mountains|United Arab Emirates photographs taken on 2020-09-12|Mountains in the morning|Taken with Olympus E-M1 Mark III|Natural heritage of United Arab Emirates without proper IDs","size_bytes":6567346,"license_url":"https://creativecommons.org/licenses/by-sa/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/5/59/Mountains_of_Wadi_Shawka_denoised.jpg/330px-Mountains_of_Wadi_Shawka_denoised.jpg"},{"date":"2006-01-20","mime":"image/jpeg","title":"Mt Herschel, Antarctica, Jan 2006.jpg","width":2592,"author":"Andrew Mandemaker","credit":"Photo taken by Andrew Mandemaker.","height":1944,"license":"CC BY-SA 2.5","page_url":"https://commons.wikimedia.org/wiki/File:Mt_Herschel,_Antarctica,_Jan_2006.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/d/db/Mt_Herschel%2C_Antarctica%2C_Jan_2006.jpg","categories":"Mount Herschel|Admiralty Mountains|Taken with Sony DSC-W1|Victoria Land|Transantarctic Mountains|Cape Hallett|Self-published work|Commons featured desktop backgrounds|Featured pictures of Antarctica","size_bytes":2238521,"license_url":"https://creativecommons.org/licenses/by-sa/2.5","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/d/db/Mt_Herschel%2C_Antarctica%2C_Jan_2006.jpg/330px-Mt_Herschel%2C_Antarctica%2C_Jan_2006.jpg"},{"date":"2009-10-18 15:43:48","mime":"image/jpeg","title":"Chola Mountain Lake, Nepal.jpg","width":4032,"author":"Vyacheslav Argenberg","credit":"Own work","height":2688,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Chola_Mountain_Lake,_Nepal.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/5/5f/Chola_Mountain_Lake%2C_Nepal.jpg","categories":"Mountains of Nepal|Photos by Vyacheslav Argenberg|Valleys of Nepal|Glacial lakes of Nepal|Proglacial lakes|Self-published work|Files with Assessments template missing SDC Commons quality assessment|Glacial rivers|Moraines in Nepal|Alluvial fans in Nepal|Files with coordinates missing SDC location of creation|Upper course riverscapes|Photos by Vyacheslav Argenberg in Nepal|Glaciated mountains in Asia|Photos by Vyacheslav Argenberg in 2009","size_bytes":9026162,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/5/5f/Chola_Mountain_Lake%2C_Nepal.jpg/330px-Chola_Mountain_Lake%2C_Nepal.jpg"},{"date":"2013-06-22 14:13:00","mime":"image/jpeg","title":"Dombay, Dzhuguturlyuchat massif and glacier, Caucasus Mountains, Karachay-Cherkessia.jpg","width":4912,"author":"Vyacheslav Argenberg","credit":"Own work","height":3264,"license":"CC BY 4.0","page_url":"https://commons.wikimedia.org/wiki/File:Dombay,_Dzhuguturlyuchat_massif_and_glacier,_Caucasus_Mountains,_Karachay-Cherkessia.jpg","image_url":"https://upload.wikimedia.org/wikipedia/commons/9/97/Dombay%2C_Dzhuguturlyuchat_massif_and_glacier%2C_Caucasus_Mountains%2C_Karachay-Cherkessia.jpg","categories":"Western Caucasus|Photos by Vyacheslav Argenberg|Teberda Nature Reserve|Self-published work|Mountains with clouds in Russia|Russia photographs taken on 2013-06-22|Files with coordinates missing SDC location of creation|Mountains with snow in Russia|Clouds and blue sky in Karachay-Cherkessia|Snow in Europe in June 2013|Shadows of clouds on mountains|Caucasus mountains of Karachay-Cherkessia|Glaciated mountains|Photos by Vyacheslav Argenberg in 2013|Photos by Vyacheslav Argenberg in Caucasus, Russia|Files with Assessments template missing SDC Commons quality image assessment","size_bytes":14530340,"license_url":"https://creativecommons.org/licenses/by/4.0","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/9/97/Dombay%2C_Dzhuguturlyuchat_massif_and_glacier%2C_Caucasus_Mountains%2C_Karachay-Cherkessia.jpg/330px-Dombay%2C_Dzhuguturlyuchat_massif_and_glacier%2C_Caucasus_Mountains%2C_Karachay-Cherkessia.jpg"}]},"meta":{"timestamp":"2026-05-31T11:06:35.844Z","request_id":"a752b399-118a-4e0b-8184-c9b3bf591f33"},"status":"ok","message":"Media searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Search and look up freely-licensed (Creative Commons / public-domain) images and media from Wikimedia Commons. /v1/search?q= returns matching files with direct image URLs, thumbnails, dimensions, license and author; /v1/image?title= returns one file's full details. Always check the per-file license before reuse.","source":"Wikimedia Commons (commons.wikimedia.org)","endpoints":["/v1/search","/v1/image","/v1/meta"]},"meta":{"timestamp":"2026-05-31T11:06:35.901Z","request_id":"71a5a6ca-eee7-4609-8a5e-d97a5bcd4548"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":450,"monthly_call_quota":49800,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1280,"monthly_call_quota":244000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3430,"monthly_call_quota":1207000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/commons-api"}