---
title: "Get Instagram User Posts"
method: GET
path: "/instagram/user/posts"
tags: ["Instagram"]
---

# Get Instagram User Posts

`GET /instagram/user/posts`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/instagram/user/posts`
- Auth: API key in header `X-API-KEY`

Retrieve an Instagram user's posts with pagination support.

## Query parameters

- `username` string, required
- `max_id` string, nullable

## Response `200`

- object
  - `success` boolean, required
  - `found` boolean, required
  - `username` string
  - `posts` object[], required
    - `id` string, nullable, required
    - `shortcode` string, nullable, required
    - `media_type` string, required
    - `caption` string, nullable, required
    - `hashtags` string[], required
    - `taken_at` string, nullable, required
    - `taken_at_timestamp` integer, nullable, required
    - `like_count` integer, required
    - `comment_count` integer, required
    - `play_count` integer, nullable, required
    - `view_count` integer, nullable, required
    - `media` object[], required
      - `type` string, required
      - `thumbnail_url` string, nullable, required
      - `video_url` string, nullable, required
      - `images` unknown[], nullable, required
        - unknown
      - `video_versions` unknown[], nullable, required
        - unknown
    - `location` object, nullable, required
      - `id` string, nullable, required
      - `name` string, nullable, required
      - `address` string, nullable, required
      - `city` string, nullable, required
      - `lat` number, nullable, required
      - `lng` number, nullable, required
    - `author` object, nullable, required
      - `id` string, nullable, required
      - `username` string, nullable, required
      - `full_name` string, nullable, required
      - `profile_pic_url` string, nullable, required
      - `is_verified` boolean, required
    - `collaborators` unknown[], required
      - unknown
    - `tagged_users` unknown[], required
      - unknown
    - `is_paid_partnership` boolean, required
    - `product_type` string, nullable, required
    - `permalink` string, nullable, required
  - `posts_count` integer, required
  - `more_available` boolean, required
  - `next_max_id` string, nullable, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `403`: Instagram explicitly requires login. Scrappa does not retry the login-gated resource. Profile lookups may recover from public profile data; unresolved login requirements are nonbillable and not retryable.
- `422`: Validation error
- `503`: The upstream service is temporarily unavailable. Please retry shortly.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)