Media (images/audio/video) used on a Wikipedia article API

Returns the media files used on a Wikipedia article via the REST media-list, normalized: total count, a breakdown by type, and per-item {title, type, leadImage flag, cleaned caption, https thumbnail}. Answers 'images on the X article', 'lead image for X', 'media gallery for a topic'.

Price$0.01per request

MethodPOST

Route/v1/data/wiki-page-media

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

datawikipediamediaimagesgallerycommonsthumbnailwikimedia

API URLhttps://x402.hexl.dev/v1/data/wiki-page-media

Integration docs

Example request

{
  "title": "Albert Einstein",
  "limit": 4
}

Example response

{
  "title": "Albert Einstein",
  "mediaCount": 36,
  "byType": {
    "image": 35,
    "audio": 1
  },
  "items": [
    {
      "title": "File:Albert_Einstein_Head_cleaned.jpg",
      "type": "image",
      "leadImage": true,
      "caption": null,
      "thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/2/28/Albert_Einstein_Head_cleaned.jpg/1280px-Albert_Einstein_Head_cleaned.jpg"
    },
    {
      "title": "File:03_ALBERT_EINSTEIN.ogg",
      "type": "audio",
      "leadImage": false,
      "caption": null,
      "thumbnail": null
    },
    {
      "title": "File:Albert_Einstein_at_the_age_of_three_(1882).jpg",
      "type": "image",
      "leadImage": false,
      "caption": "Einstein in 1882, age 3",
      "thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/f/fb/Albert_Einstein_at_the_age_of_three_%281882%29.jpg/330px-Albert_Einstein_at_the_age_of_three_%281882%29.jpg"
    },
    {
      "title": "File:Hermann_einstein.jpg",
      "type": "image",
      "leadImage": false,
      "caption": null,
      "thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/6/66/Hermann_einstein.jpg/330px-Hermann_einstein.jpg"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Article title."
    },
    "limit": {
      "type": "number",
      "description": "Max media items 1-50 (default 20)."
    },
    "project": {
      "type": "string",
      "description": "Wikimedia project host (default 'en.wikipedia')."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}