Overview

Returns a player's image gallery, including image titles, source attribution, direct image URLs, and compatibility flags.

Use this endpoint when you need the available gallery images for a player profile or media display.

Inputs

id (string, required): Transfermarkt player ID. Example: 68290 for Neymar.

Response

The endpoint returns a JSON object with:

success (boolean): Whether the request succeeded.
message (string): Status message, such as OK.
data (object): Gallery data.
playerId (string): The requested player ID.
images (array): Gallery image records. Each record contains:
title (string): Caption or description for the image.
url (string): Direct image URL.
source (string): Image credit/source, such as IMAGO or Getty Images.
isPremium (boolean): Whether the image is marked premium.
isAppHeaderCompatible (boolean): Whether the image is compatible for an app header.

The gallery can contain many images; the verified response contained more than 20 records. The examples below are trimmed from that response.

Auth & browser

Authentication is not required. The endpoint is a JSON API request and does not require browser context (useContext: false, useFetch: false).

Examples

Request

{
  "id": "68290"
}

Success response

{
  "success": true,
  "message": "OK",
  "data": {
    "playerId": "68290",
    "images": [
      {
        "title": "Neymar, Brazil, WC 2026",
        "url": "https://img.a.transfermarkt.technology/foto/galerie/neymar-brazil-wc-2026-1783314293-201605.jpg",
        "source": "IMAGO",
        "isPremium": true,
        "isAppHeaderCompatible": true
      },
      {
        "title": "Neymar - Brazil, 2026",
        "url": "https://img.a.transfermarkt.technology/foto/galerie/neymar-brazil-2026-1781667545-200089.jpg",
        "source": "IMAGO",
        "isPremium": true,
        "isAppHeaderCompatible": true
      },
      {
        "title": "Neymar, PSG",
        "url": "https://img.a.transfermarkt.technology/foto/galerie/neymar-psg-1583319208-33106.jpg",
        "source": "IMAGO",
        "isPremium": true,
        "isAppHeaderCompatible": true
      },
      {
        "title": "Neymar da Silva Santos Júnior",
        "url": "https://img.a.transfermarkt.technology/foto/galerie/neymar-da-silva-santos-junior-1401788457-222.jpg",
        "source": "Getty Images",
        "isPremium": true,
        "isAppHeaderCompatible": true
      }
    ]
  }
}

Notes

The images array is variable-length and may be empty for players without gallery entries.
Image URLs are returned as absolute HTTPS URLs and can be used directly by clients.
The verified response contained additional gallery items beyond the trimmed example.
Image titles and source labels may vary by image and may include accented player or country names.