---
title: "Get a shared folder's preview image"
description: "The image link previews show for a shared folder's link (markdrop.in/f/<share-id>), as PNG, with the same rules as Get a folder's preview image."
canonical_url: https://docs.markdrop.in/api/folders/get-a-shared-folder-s-preview-image
last_updated: 2026-11-04
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Get a shared folder's preview image

`GET https://api.markdrop.in/api/v1/og/f/{share_id}.png`

The image link previews show for a shared folder's link (`markdrop.in/f/<share-id>`), as PNG, with the same rules as [Get a folder's preview image](https://docs.markdrop.in/api/folders/get-a-folder-s-preview-image).

- **Authentication:** No token needed.
- **Rate limit:** 120 per minute per IP address.
- **Guide:** [Share a folder](https://docs.markdrop.in/workspaces/share-a-folder)

## Path parameters

- `share_id` (string, required)

## Query parameters

- `path` (string): A subfolder's path below the shared folder. Up to 1,000 characters. Default `""`.

## Responses

- `200`: OK.
- `422`: The request didn't validate. `detail` lists each problem, with where it is (`loc`) and why (`msg`).
- `429`: Too many requests from your IP address. Wait the seconds in `Retry-After`.

## Examples

**curl**

```bash
curl https://api.markdrop.in/api/v1/og/f/SHARE_ID.png
```

**JavaScript**

```javascript
const res = await fetch("https://api.markdrop.in/api/v1/og/f/SHARE_ID.png");
const data = await res.blob();
```

**Python**

```python
import requests

r = requests.get("https://api.markdrop.in/api/v1/og/f/SHARE_ID.png")
r.raise_for_status()
open("out.png", "wb").write(r.content)
```