> ## Documentation Index
> Fetch the complete documentation index at: https://traceryn.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Reading pins

> Fetch a Pinterest pin with Pinto from a URL, short link, path, or pin ID.

`getPin` accepts almost any Pinterest reference:

* a full URL
* a short link (`pin.it/...`)
* a `/pin/<id>/` path
* a regional host (`br.pinterest.com/...`)
* a bare pin ID

```ts theme={null}
const pin = await pinto.getPin(
  "https://www.pinterest.com/pin/1060738518503398158/",
);
```

## Pin fields

**id** `string`

Pin ID, for example `"1060738518503398158"`.

**title** `string`

Pin title.

**description** `string`

Pin description.

**image** `string`

Highest-resolution image URL.

**images** `\{ url, width?, height? \}[]`

All image variants, sorted largest first.

**isVideo** `boolean`

`true` for video and story pins.

**video** `string`

Best `.mp4` URL. Empty for plain image pins.

**link** `string`

Outbound link, if the pinner attached one.

**domain** `string`

Source domain, if any.

**altText** `string`

SEO or auto-generated alt text, if present.

**createdAt** `number`

Creation time in epoch milliseconds, if present.

**pinner** `\{ id?, username?, fullName?, image? \}`

The user who saved the pin.

**board** `\{ id?, name?, url? \}`

The board the pin belongs to.

A deleted or unknown pin throws `NotFoundError`. See [Error handling](https://traceryn.online/pinto/errors.md).

To download the pin's image or video, see [Downloading media](https://traceryn.online/pinto/media.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.