Core REST API/Reference/Pages/Get files

GET /core/v1/{project}/{language}/page/{title}/links/media

Returns information about media files used on a wiki page, up to 100 files.

Examples

curl

# Get media files used on the Earth article on English Wikipedia
$ curl https://api.wikimedia.org/core/v1/wikipedia/en/page/Earth/links/media

Python

# Python 3
# Get media files used on the Earth article on English Wikipedia

import requests

page = 'Earth'
url = 'https://api.wikimedia.org/core/v1/wikipedia/en/page/' + page + '/links/media'

headers = {
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
  'User-Agent': 'YOUR_APP_NAME (YOUR_EMAIL_OR_CONTACT_PAGE)'
}

response = requests.get(url, headers=headers)
data = response.json()
print(data)

PHP

<?php
// Get media files used on the Earth article on English Wikipedia

$url = 'https://api.wikimedia.org/core/v1/wikipedia/en/page/Earth/links/media';
$authorization = 'Authorization: Bearer YOUR_ACCESS_TOKEN';

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_HTTPHEADER, array( $authorization ));
curl_setopt( $ch, CURLOPT_USERAGENT, 'YOUR_APP_NAME (YOUR_EMAIL_OR_CONTACT_PAGE)' );
$output = curl_exec( $ch );
curl_close( $ch );

echo( $output );
?>

JavaScript

// Get media files used on the Earth article on English Wikipedia

let url = 'https://api.wikimedia.org/core/v1/wikipedia/en/page/Earth/links/media';
let response = await fetch( url,
    {
        headers: {
            'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
            'Api-User-Agent': 'YOUR_APP_NAME (YOUR_EMAIL_OR_CONTACT_PAGE)'
        }
    }
);
response.json()
    .then(console.log).catch(console.error);

Parameters

project

required path

Project name. For example: wikipedia (encyclopedia articles), commons (images, audio, and video), wiktionary (dictionary entries). List all projects.
language

required path

Language code. For example: ar (Arabic), en (English), es (Spanish). List supported languages.
Note: The language parameter is prohibited for commons and other multilingual projects.
title

required path

Wiki page title

Responses

200 Success: Media files found. Returns files object containing an array of files.
Example
{
  "files": [
    {
      "title": "Commons-logo.svg",
      "file_description_url": "//en.wikipedia.org/wiki/File:Commons-logo.svg",
      "latest": {
        "timestamp": "2016-04-05T22:33:52Z",
        "user": {
          "id": 161142,
          "name": "RHaworth"
        }
      },
      "preferred": {
        "mediatype": "DRAWING",
        "size": null,
        "width": 446,
        "height": 599,
        "duration": null,
        "url": "//upload.wikimedia.org/wikipedia/en/thumb/4/4a/Commons-logo.svg/446px-Commons-logo.svg.png"
      },
      "original": {
        "mediatype": "DRAWING",
        "size": 932,
        "width": 1024,
        "height": 1376,
        "duration": null,
        "url": "//upload.wikimedia.org/wikipedia/en/4/4a/Commons-logo.svg"
      }
    }
  ]
}
404 Error: Title not found
Example
{
  "messageTranslations": {
    "en": "The specified title does not exist"
  },
  "httpCode": 404,
  "httpReason": "Not Found"
}
500 Error: Page contains more than 100 media files
Example
{
  "messageTranslations": {
    "en": "Too many media links found on title (100 allowed)"
  },
  "httpCode": 500,
  "httpReason": "Internal Server Error"
}