Reading public artwork needs no account, key or token.
Fetch a Show
Section titled “Fetch a Show”curl https://api.mediux.io/shows/1399The Show is under data. The Show reference
has a full example response.
From JavaScript
Section titled “From JavaScript”const response = await fetch("https://api.mediux.io/shows/1399", { credentials: "omit",});
if (!response.ok) { const { error } = await response.json().catch(() => ({})); throw new Error(error?.code ?? `HTTP ${response.status}`);}
const { data } = await response.json();console.log(data.title);This works in a browser too. Use GET or HEAD, leave credentials out, and
don’t add query parameters: public paths take none.
Show its poster
Section titled “Show its poster”Images come back as an ID and an extension. Add them to the image host:
const { id, extension } = data.metadataImages.poster;const poster = `https://img.mediux.io/metadata/original/${id}.${extension}`;Build image URLs covers resized versions and community artwork.
Next steps
Section titled “Next steps”- Browse the public endpoints for titles, Sets, creators, Lists, feeds and YAML exports.
- Learn the response format and error codes.
- To act for a user, connect your app with OAuth.