---
title: "Instagram Stats"
method: GET
path: "/instagram/stats"
tags: ["Instagram"]
---

# Instagram Stats

`GET /instagram/stats`

## Request

- Base URL: `https://api.fetchfox.net`
- URL: `https://api.fetchfox.net/instagram/stats`
- Auth: API key in header `x-access-key`

Get engagement metrics and metadata for an Instagram post or reel. Views are optional by default: returns media immediately with null for unavailable views. Set requireViews=true to require a verified count; unavailable strict requests return 503 without a charge.

## Query parameters

- `url` string, required
- `access_key` string
- `requireViews` unknown

## Response `200`

Post stats retrieved successfully

- object: Post stats retrieved successfully
  - `success` boolean, required
  - `data` object, required
    - `postUrl` string
    - `id` string
    - `shortcode` string
    - `title` string
    - `description` string
    - `views` integer, nullable: Null when unavailable or not applicable to this media type. A verified zero video count is preserved.
    - `videoUrl` string: Temporary Instagram video CDN URL
    - `likes` integer
    - `comments` integer
    - `shares` integer, nullable: Unavailable from the current Instagram extractor; returns null.
    - `publishedAt` string
    - `author` string
    - `authorLink` string
    - `duration` string, nullable
    - `thumbnail` string
    - `isVideo` boolean
    - `contentType` string

## Other responses

- `400`: Invalid or missing request input
- `401`: Access key is missing
- `403`: Access key is invalid or the project has insufficient credits
- `404`: Content not found or unavailable
- `422`: Unsupported input or documented media restriction
- `429`: Project rate limit exceeded
- `500`: Internal server error
- `502`: Upstream query rejected or malformed response
- `503`: Upstream service temporarily unavailable; retry later
- `504`: Extraction or upstream operation timed out

---

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