Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/search

Search Commons for media

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/commons-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/commons-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/commons-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/commons-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/commons-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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 cir
…