# Get post or reel (v1)

Get a post or reel by `url` or `code`: caption, media files, like, comment and play counts, owner, tagged users and location. A removed or unavailable post returns `data: null`.

- Platform: Instagram
- Request: `GET https://api.toolzerhub.com/v1/instagram/media`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/instagram/post/get-instagram-media

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `url` | query | no | string | Post or reel URL (/p/, /reel/, /reels/ or /tv/). Send exactly one of url or code. |
| `code` | query | no | string | Shortcode from the post URL, DZpQwxqimz2 in instagram.com/p/DZpQwxqimz2/. Send exactly one of url or code. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/instagram/media" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.