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
| Link | Width | Format |
|---|---|---|
thumb_url | up to 320 px | WebP |
medium_url | up to 1024 px | WebP |
url | original | as 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.
Signed links
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.