# Get started

> Make your first request in a minute, with no account or key.

Reading public artwork needs no account, key or token.

## Fetch a Show

```sh
curl https://api.mediux.io/shows/1399
```

The Show is under `data`. The [Show reference](https://docs-preview.mediux.io/api/reference/shows/retrieve.md)
has a full example response.

## From JavaScript

```js
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

Images come back as an ID and an extension. Add them to the image host:

```js
const { id, extension } = data.metadataImages.poster;
const poster = `https://img.mediux.io/metadata/original/${id}.${extension}`;
```

[Build image URLs](https://docs-preview.mediux.io/api/guides/image-urls.md) covers resized versions and
community artwork.

## Next steps

- Browse the [public endpoints](https://docs-preview.mediux.io/api/reference.md) for titles, Sets, creators,
  Lists, feeds and YAML exports.
- Learn the [response format and error codes](https://docs-preview.mediux.io/api/errors.md).
- To act for a user, [connect your app with OAuth](https://docs-preview.mediux.io/api/authentication.md).
