> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraper.creatorlookup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Post

> Retrieve a single Instagram post by shortcode

## Request

### Headers

| Name        | Required | Description  |
| ----------- | -------- | ------------ |
| `x-api-key` | Yes      | Your API key |

### Query parameters

<ParamField query="shortcode" type="string" required>
  The post shortcode. This is the unique identifier in Instagram post URLs:
  `https://www.instagram.com/p/{shortcode}/`
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="InstagramPost">
    <ResponseField name="shortcode" type="string">Unique post identifier</ResponseField>
    <ResponseField name="caption" type="string | null">Post caption text</ResponseField>
    <ResponseField name="timestamp" type="number">Unix timestamp</ResponseField>
    <ResponseField name="like_count" type="number">Number of likes</ResponseField>
    <ResponseField name="comment_count" type="number">Number of comments</ResponseField>
    <ResponseField name="media_type" type="string">One of: `image`, `video`, `carousel`</ResponseField>
    <ResponseField name="media_url" type="string">URL of the primary media</ResponseField>
    <ResponseField name="thumbnail_url" type="string | null">Thumbnail URL (for videos)</ResponseField>
    <ResponseField name="is_video" type="boolean">Whether the post is a video</ResponseField>
    <ResponseField name="video_view_count" type="number | null">View count (videos only)</ResponseField>
    <ResponseField name="location" type="string | null">Tagged location name</ResponseField>
    <ResponseField name="tagged_users" type="string[]">Usernames tagged in the post</ResponseField>
    <ResponseField name="hashtags" type="string[]">Hashtags extracted from the caption</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="credits_used" type="number">Credits deducted (1)</ResponseField>
<ResponseField name="credits_remaining" type="number">Remaining credit balance</ResponseField>

**Cost:** 1 credit

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: sk-your-api-key" \
    "https://api.scraper.creatorlookup.com/v1/instagram/post?shortcode=CxAbCdEfGh"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://api.scraper.creatorlookup.com/v1/instagram/post?shortcode=CxAbCdEfGh",
    { headers: { "x-api-key": "sk-your-api-key" } }
  );

  const { data } = await res.json();
  console.log(data.caption);
  console.log(data.like_count);
  console.log(data.media_type); // "image", "video", or "carousel"
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://api.scraper.creatorlookup.com/v1/instagram/post",
      params={"shortcode": "CxAbCdEfGh"},
      headers={"x-api-key": "sk-your-api-key"},
  )

  data = res.json()["data"]
  print(data["caption"])
  print(data["like_count"])
  print(data["media_type"])  # "image", "video", or "carousel"
  ```
</CodeGroup>

### 200 — Success

```json theme={null}
{
  "data": {
    "shortcode": "CxAbCdEfGh",
    "caption": "Beautiful sunset #nature #photography",
    "timestamp": 1700000000,
    "like_count": 50000,
    "comment_count": 800,
    "media_type": "carousel",
    "media_url": "https://scontent.cdninstagram.com/...",
    "thumbnail_url": null,
    "is_video": false,
    "video_view_count": null,
    "location": "Malibu, California",
    "tagged_users": [],
    "hashtags": ["nature", "photography"]
  },
  "credits_used": 1,
  "credits_remaining": 9999
}
```

### 502 — Scrape failed

```json theme={null}
{
  "error": {
    "code": "SCRAPE_FAILED",
    "message": "Post not found or has been removed"
  }
}
```