---
title: "Instagram Post Details"
method: GET
path: "/v1/instagram/post"
tags: ["Instagram"]
---

# Instagram Post Details

`GET /v1/instagram/post`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/instagram/post`
- Auth: API key in header `X-API-Key`

Look up a single Instagram post, reel, or IGTV video by URL, shortcode, or numeric media ID. Returns the caption, like / comment / share / view counts, media URLs, carousel slides, audio track info, tagged users, location, accessibility caption, and author details. Provide exactly one of `url` or `code`.

**Price:** $0.006 per request. **Free tier:** 50 requests/month.

## Query parameters

- `url` string
- `code` string
- `get_sentiment` boolean

## Response `200`

Successful response

- InstagramPostDetailsResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `post` object, nullable
    - `title` string, nullable
    - `url` string, nullable
    - `date` string, nullable
    - `date_timestamp` number, nullable
    - `author` string, nullable
    - `author_id` string, nullable
    - `source` string, nullable
    - `domain` string, nullable
    - `snippet` string, nullable
    - `likes` number, nullable
    - `comments` number, nullable
    - `shares` number, nullable
    - `reposts` number, nullable
    - `views` number, nullable
    - `is_video` boolean, nullable
    - `media_type` string, nullable
    - `author_verified` boolean, nullable
    - `author_name` string, nullable
    - `hashtags` string[], nullable
    - `mentions` string[], nullable
    - `media_id` string, nullable
    - `thumbnail_url` string, nullable
    - `video_url` string, nullable
    - `video_duration` number, nullable
    - `width` number, nullable
    - `height` number, nullable
    - `carousel_media_count` number, nullable
    - `is_paid_partnership` boolean, nullable
    - `ai_label` object, nullable
      - `label` unknown
      - `detection_method` string, nullable
    - `location` unknown
    - `tagged_users` object[], nullable
      - `username` string, nullable
      - `full_name` string, nullable
      - `user_id` string, nullable
    - `coauthors` unknown[], nullable
      - unknown
    - `carousel_media` unknown[], nullable
      - unknown
    - `audio` object, nullable
      - `type` string, nullable
      - `title` string, nullable
      - `artist` string, nullable
      - `audio_id` string, nullable
      - `duration_ms` number, nullable
    - `is_pinned` boolean, nullable
    - `accessibility_caption` string, nullable

## Other responses

- `400`: Bad request: missing both parameters, both provided, or a value invalid or too long
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `404`: Instagram post not found
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving Instagram data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)