Skip to main content
POST
/
api
/
wikimedia_commons
/
files
/
search
/wikimedia_commons/files/search
curl --request POST \
  --url https://api.anysite.io/api/wikimedia_commons/files/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "depicts": "Q146",
  "mime": "image/jpeg",
  "sort": "relevance"
}
'
[
  {
    "id": 123,
    "title": "<string>",
    "@type": "@wikimedia_commons_search_result",
    "image": "",
    "thumbnail": "<string>",
    "description_url": "",
    "web_url": "",
    "width": 123,
    "height": 123,
    "size": 123,
    "mime": "<string>",
    "media_type": "<string>",
    "uploaded_by": "<string>",
    "uploaded_at": "<string>",
    "description": "<string>",
    "license_short_name": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
keyword
string
required

Full-text search query

Minimum string length: 1
Example:

"domestic cat"

​
count
integer
required

Number of files to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
depicts
string | null

Wikidata item id of a depicted concept to filter by

Example:

"Q146"

​
mime
string | null

Filter by MIME type

Example:

"image/jpeg"

​
file_type
enum<string> | null

Filter by media type

Available options:
bitmap,
drawing,
audio,
video,
office,
pdf
​
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
last_edit_desc,
last_edit_asc,
create_timestamp_desc,
create_timestamp_asc

Response

Successful Response

​
id
integer
required
​
title
string
required
​
@type
string
default:@wikimedia_commons_search_result
​
image
string
default:""
​
thumbnail
string | null
​
description_url
string
default:""
​
web_url
string
default:""
​
width
integer | null
​
height
integer | null
​
size
integer | null
​
mime
string | null
​
media_type
string | null
​
uploaded_by
string | null
​
uploaded_at
string | null
​
description
string | null
​
license_short_name
string | null