Skip to content
MediuxDocs

Get started

Reading public artwork needs no account, key or token.

Terminal window
curl https://api.mediux.io/shows/1399

The Show is under data. The Show reference has a full example response.

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.

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.