# Instagram / Post

Fetch public details for a single post.

```
GET /api/v1/instagram/post
```

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

## Parameters

| Name | Required | Description | Example |
|------|----------|-------------|---------|
| `code` | no | Exactly one of code or url. Prefer shortcode. | `C-6WRvdS75Q` |
| `url` | no | Full Instagram post URL (alternative to code). | `https://www.instagram.com/p/C-6WRvdS75Q/` |

## Example

```bash
curl -s 'https://trysocify.com/api/v1/instagram/post?code=C-6WRvdS75Q' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Media id. |
| `code` | string | Shortcode. |
| `url` | string | Post URL. |
| `caption` | string | Caption text. |
| `type` | string | image, video, or carousel. |
| `created_at` | number | Unix publish timestamp. |
| `likes` | number | Like count. |
| `comments` | number | Comment count. |
| `views` | number | View/play count, when available. |
| `thumbnail` | string | Thumbnail URL. |
| `video_url` | string | Video URL, when available. |
| `author` | object | Author username and id. |
## Sample response

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

```json
{
  "ok": true,
  "platform": "instagram",
  "resource": "post",
  "params": {
    "code": "C-6WRvdS75Q"
  },
  "data": {
    "author": {
      "id": "787132",
      "username": "natgeo"
    },
    "caption": "A lion rests on the savanna.",
    "code": "C-6WRvdS75Q",
    "comments": 4653,
    "created_at": 1724199751,
    "id": "3439159241662512720",
    "likes": 642848,
    "thumbnail": "https://scontent.cdninstagram.com/v/t51.29350-15/example.jpg",
    "type": "image",
    "url": "https://www.instagram.com/p/C-6WRvdS75Q/",
    "video_url": "",
    "views": 0
  },
  "meta": {
    "credits_charged": 1,
    "latency_ms": 420,
    "platform": "instagram",
    "resource": "post",
    "path": "/api/v1/instagram/post"
  }
}
```

## Links

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