---
title: "Instagram Channel Posts"
method: GET
path: "/instagram/channel-posts"
tags: ["Instagram"]
---

# Instagram Channel Posts

`GET /instagram/channel-posts`

## Request

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

Get recent posts from an Instagram profile's feed.

## Query parameters

- `url` string, required
- `limit` integer
- `access_key` string

## Response `200`

Channel posts retrieved successfully

- object: Channel posts retrieved successfully
  - `success` boolean, required
  - `data` object, required
    - `profileUrl` string
    - `username` string
    - `items` object[]
      - `id` string
      - `shortcode` string
      - `url` string
      - `type` string
      - `caption` string
      - `duration` unknown
      - `likes` integer
      - `comments` integer
      - `views` unknown
      - `plays` unknown
      - `timestamp` integer
      - `thumbnailUrl` string
      - `imageCollection` object
        - `status` 'complete' | 'partial' | 'unavailable' | 'unknown' | 'not_applicable', required: Image metadata coverage, not a guarantee that temporary URLs remain retrievable.
        - `order` 'source' | 'unknown', required
        - `sourceMediaCount` integer, nullable, required: Original media count including videos, or null when unknown.
        - `items` object[], required
          - `id` string, nullable, required
          - `position` integer, nullable, required: One-based original slot, including skipped video slots; null when not provable.
          - `url` string, nullable, required: Temporary upstream image URL, not permanent storage.
          - `status` 'available' | 'unavailable', required
      - `author` object
        - `id` string
        - `username` string
        - `fullName` string
        - `isVerified` boolean
        - `profilePicUrl` string
    - `count` integer
    - `hasMore` boolean
    - `cursor` 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)