# StoryGrab - Embed & Short URL Documentation

Distribute and embed grabbed posts cleanly across the web.

## 1. Short URLs

Every grabbed post and story has a dedicated short URL that automatically handles redirections. When a user visits the short URL, they are immediately redirected to the profile view with the corresponding media overlay loaded automatically.

**Redirect Link:** `https://storygrab.net/s/{id}`

*Example:* `https://storygrab.net/s/01kty5z12x8hb5z48x9d0j3xyz` will redirect to the post's owner's profile page and launch the viewer modal automatically.

## 2. Iframe Embeds

Embed any grabbed post directly onto external blogs, dashboards, or websites. The embed page delivers a clean, responsive layout optimised for mobile and desktop screens, including native support for image posts, carousel navigation, and video playback.

**Endpoint:** `GET /embed/post/{id}`

### HTML Embed Code

```html
<iframe src="https://storygrab.net/embed/post/01kty5z12x8hb5z48x9d0j3xyz" 
        width="100%" 
        height="520" 
        style="border: none; border-radius: 16px; max-width: 480px; background: #09090b; overflow: hidden;" 
        scrolling="no" 
        allowtransparency="true">
</iframe>
```

## Embed Specifications

| Property | Type | Recommended Value | Description |
| :--- | :--- | :--- | :--- |
| `width` | String | `100%` | Makes the iframe responsive. Responsive styling caps at max-width. |
| `max-width` | String | `480px` or `500px` | Caps the container size to match the original aspect ratio of Instagram cards. |
| `height` | String / Number | `520px` | Sufficient height to display the post media, profile header, and comments/caption area. |
| `scrolling` | String | `no` | Prevents duplicate browser scrollbars within the embed widget container. |