# Instagram / Stories

Fetch current public stories for a profile.

```
GET /api/v1/instagram/stories
```

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
Credits: 1 credit per request

## Parameters

| Name | Required | Description | Example |
|------|----------|-------------|---------|
| `username` | yes | Instagram username without @. | `natgeo` |

## Example

```bash
curl -s 'https://trysocify.com/api/v1/instagram/stories?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `stories` | array | Active story items. |
| `stories[].id` | string | Story media id. |
| `stories[].type` | string | image or video. |
| `stories[].thumbnail` | string | Thumbnail URL. |
| `stories[].video_url` | string | Video URL, when available. |
| `stories[].created_at` | number | Unix timestamp. |
## Sample response

Successful lookups wrap the payload in `{ ok, platform, resource, params, data, meta }`. `data` is shown below.

```json
{
  "ok": true,
  "platform": "instagram",
  "resource": "stories",
  "params": {
    "username": "natgeo"
  },
  "data": {
    "stories": [
      {
        "created_at": 1724200000,
        "id": "3512345678901234567",
        "thumbnail": "https://scontent.cdninstagram.com/v/t51.2885-15/example.jpg",
        "type": "video",
        "video_url": "https://scontent.cdninstagram.com/v/t50.2886-16/example.mp4"
      }
    ]
  },
  "meta": {
    "credits_charged": 1,
    "latency_ms": 420,
    "platform": "instagram",
    "resource": "stories",
    "path": "/api/v1/instagram/stories"
  }
}
```

## Links

- HTML docs: https://trysocify.com/docs/api/instagram/stories
- SEO page: https://trysocify.com/instagram/stories
- OpenAPI: https://trysocify.com/openapi.json
- Catalog: https://trysocify.com/catalog.json