Docs / Catalog

Photos

Photo sizes, signed links, and the license on each one.

Each item's images lists its approved photos, box front first:

{
  "id": "…",
  "kind": "box_front",
  "caption": null,
  "width": 1600, "height": 1600, "mime": "image/jpeg",
  "url": "https://tablearchive.dev/v1/images/…/file?exp=…&sig=…",
  "medium_url": "https://tablearchive.dev/v1/images/…/file?size=medium&exp=…&sig=…",
  "thumb_url": "https://tablearchive.dev/v1/images/…/file?size=thumb&exp=…&sig=…",
  "source_page_url": "https://commons.wikimedia.org/wiki/File:…",
  "license": "CC BY-SA 3.0",
  "attribution": "Matěj Baťha"
}

Sizes

LinkWidthFormat
thumb_urlup to 320 pxWebP
medium_urlup to 1024 pxWebP
urloriginalas uploaded

Photos are never enlarged. Use thumb_url in lists and medium_url on detail pages.

Who gets them

Photos carry other people's licenses, so photo links go to requests with a key or a session. Without one, image is filled on the first page of a list only (offset=0), later pages get null, and an item's images is []; image_count says how many there are.

Photo links carry exp and sig and work without a key for a few hours, so a plain <img> tag can show them. Fetch the item again for fresh ones rather than storing the links.

What a photo shows

kind is one of box_front, box_back, box_side, components, detail, gameplay, or other.

Licenses

Every photo keeps its own license and attribution, which you must carry along when you show it. Many come from Wikimedia Commons under Creative Commons licenses; publishers' photos are shown with their permission and may not be reused outside your use of this API. Where license is null, treat the photo as all rights reserved.

To add a photo, see Uploading photos.